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EDITORIAL 



Welcome to another issue of Full Circle. 


T here's no Python or Blender tutorials this month. I've stepped in to fill the Blender space 
with a GIMP article on using the Prespective Clone tool. For the Python space I thought 
I'd throw in a quirky article I was sent on how to set up dcm4che. It's a piece of software used 
in P.E.T. scanning machines in the medical field. I love receiving articles like this as it shows us 
a side of Linux that we rarely get to see. So, if you're in a field of work which uses Linux, and 
is something that most people never see, send us an article. The quirkier the better! 

My recent gaming addiction (which has taken over from Euro Truck Simulator 2) is X-Plane 
1 0. 1 bought a MAD CATZ FLY5 joystick and have taken to the (virtual) skies and written a 
review of X-Plane this month. There's a lot to learn, but it's a great simulation. Also this 
month in gaming there's a review from Oscar on The Witcher 2. 

For the tinkerers out there I'm plodding along with Arduino, while Charles is messing 
around with Kodi (formerly known as XBMC), and we're on to part two of the Kernel series. 


No one wrote to me this month so I'm afraid there's no Letters page. No questions on 
security means that's also out this month. I believe these are also my last two desktop 
screens. 


This magazine was created using : 



LibreOffice 
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1(0 creative 
o 1 commons 


Full Circle Podcast 

Released monthly, each episode 
covers all the latest Ubuntu news, 
opinions, reviews, interviews and 
listener feedback. The Side-Pod is 
a new addition, it's an extra 
(irregular) short-form podcast 
which is intended to be a branch 
of the main podcast. It's 
somewhere to put all the general 
technology and non-Ubuntu stuff 
that doesn’t fit in the main 
podcast. 


Anyway, that's enough rambling from me. Enjoy the issue, and write in! 


All the best, and keep in touch! 

Ronnie 

ronnie@fullcirclemaqazine.org 



Hosts: 

• Les Pounder 

• Tony Hughes 

• Jon Chamberlain 

• Oliver Clark 



http://fullcirclemaqazine.org 
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IBM DOUBLES DOWN ON 
Linux 

L ess than a year after their 
announcement that they 
planned to invest a billion dollars in 
the Linux platform, IBM continues 
to ramp up their Linux play by 
rolling out Linux on Power System 
servers across 54 of the IBM 
Innovation and Client Centers 
worldwide. This comes almost two 
years after IBM announced that 
they had ported Linux to the 
Power Server platform. 

The new services, announced 
last week at LinuxCon North 
America, are designed to get 
customers up and running on the 
Power Server environment while 
keeping their options open in 
terms of Linux flavor and 
applications. Support and training 
is now available to developers to 
build applications that can make 
use of the virtualization and 
parallel processing features of the 
Power Systems servers using 
Canonical Ubuntu Linux, Red Hat 
Enterprise Linux, and SUSE 


Enterprise Server. 

Source: 

http://www.zdnet.com/ibm- 

doubles-down-on-linux- 

7000033088/ 

Submitted by: ArnPried Walbrecht 


Ubuntu 14.10 (Utopic 
Unicorn), Beta 1 preview: 

No BIG CHANGES 

E very year by about this time, 
with the release of the first 
beta, most Ubuntu commentators 
have already filed their final story 
on Ubuntu x.1 0 for the 
desktop — well in advance of the 
final release in October. This time 
around, with the upcoming release 
of Ubuntu 14.10 (Utopic Unicorn) 
for the desktop, the mediasphere is 
surprisingly quiet on the subject, 
and there's not much news coming 
out of Canonical. Mark 
Shuttleworth's recent blogposts 
are all about the cloud friendliness 
of Canonical's products, and so far 
have nothing to say about the new 


desktop release. 

Jono Bacon's blog, usually a 
helpful information source, no 
longer applies, since Bacon left 
Canonical and his post as Ubuntu 
community manager at the end of 
May to become senior director of 
community at XPRIZE. Until a 
replacement for Bacon is 
announced, the four-person 
Ubuntu community team will 
bridge the gap. 

Like the rest of the industry, 
Canonical seems to be focusing the 
majority of its development 
resources on smartphones and 
tablets, with the desktop version of 
Ubuntu now taking something of a 
back seat. 

Source: 

http://www.zdnet.com/ubuntu-14- 

1 0-utopic-unicorn-beta-1 -preview- 

no-biq-chanqes-700003301 9/ 
Submitted by: ArnPried Walbrecht 


5 TIPS ON MIGRATING TO 
OPEN-SOURCE SOFTWARE 

O pen source is not just for 

Linux. Yes, you'll certainly find 
a much larger selection of open- 
source software for the Linux 
platform, but both Windows and 
Apple also enjoy a good number of 
titles. Regardless of what Free 
Open Source Software (FOSS) you 
need to use, you might not always 
find it the most natural 
evolution — especially when you've 
spent the whole of your career 
using proprietary software. The 
thing is, a lot of open-source 
software has matured to the point 
where it rivals (and sometimes 
bests) its proprietary counterpart. 

With that in mind, I wanted to 
offer up my five best tips for 
migrating from a closed-software 
ecosystem to an open one. This 
may mean you're just dropping 
Microsoft Office for 
LibreOffice — or you might be 
diving into deeper open-source 
waters and migrating from 
Windows to Linux. No matter the 
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change you are about to make, 
these tips should make the 
transition easier. 

Source: 

http://www.techrepublic.com/artic 

le/5-tips-on-miqratinq-to-open- 

source-software/ 

Submitted by: Arnfried Walbrecht 

Linux servers turned 
INTO BOTS BY 'IPTABLes' 
AND 'IPTABLex' MALWARE 

A botnet that infects and 
exploits poorly-maintained 
Linux servers has been used to 
launch a spate of large DDoS 
attacks targeting DNS and other 
infrastructure, Akamai's Prolexic 
division has warned. 

Dubbed the 'IptabLes and 
IptabLex botnet', the attack 
targets versions of Apache Struts 
and Tomcat, as well as some 
running Elasticsearch that have not 
been patched against a clutch of 
vulnerabilities. 

Once compromised, the attack 
elevates privileges to allow remote 
control of the server from which 
the malicious code is dropped and 


run, after which it awaits direction 
by the bot's command and control. 
The binary is connected to two 
hardcoded addresses running on 
China Telecom, while anyone 
whose server has been infected will 
probably notice poor performance. 

Source: 

http://news.techworld.com/securit 

y/3543420/linux-servers-turned- 

into-bots-bv-iptables-and-iptablex- 

malware/ 

Submitted by: Arnfried Walbrecht 

What Docker Is — and Is 
Not 

D ocker software has been 
getting quite a bit of 
attention recently, because it holds 
out the promise of making it 
possible for a developer to develop 
an application, package it into a 
container, and then deliver it to a 
number of different 
platforms — without having to test 
every combination of versions of 
the operating system, database, 
application framework or 
development tool. The goal is to 
overcome all differences in the 
versions of the operating system, 
database engines and other tools 


to make re-hosting an application 
very easy. 

Although Docker indicates that 
this is a new idea, it really can be 
seen as a form of application 
virtualization. Docker relies on a 
form of processing virtualization, 
operating system virtualization and 
partitioning that has become a 
standard part of the Linux kernel. 

Source: 

http://virtualizationreview.com/arti 

cles/201 4/09/05/what-docker-is- 

and-is-not.aspx 

Submitted by: Arnfried Walbrecht 

KlNIVO RELEASES A PAIR OF 

inexpensive Linux- 
friendly USB WIRELESS 
ADAPTERS 

N owadays, if you buy a laptop, 
it will have a built-in wireless 
card (desktops; not always). For the 
most part, these integrated cards 
work well -- on Windows. You see, 
most manufacturers build their 
machines with only Windows in 
mind. If you use only Microsoft's 
operating system, you should be 
golden. However, for nerds who 


like Linux (including myself), 
nonexistent or problematic 
wireless drivers can be an absolute 
nightmare. 

This is why I recommend a USB 
wireless adapter to every Linux 
user; you never know when you 
may need it as a permanent or 
temporary internet solution. 
Unfortunately, not all USB adapters 
work with Linux out of the box, so 
the model you choose matters. 
Today, Kinivo releases two USB 
wireless adapters that are 
promised to work with Linux-based 
operating systems. 

Source: 

http://betanews.com/201 4/09/08/ 

kinivo-releases-a-pair-of- 

inexpensive-linux-friendly-usb- 

wireless-adapters/ 

Submitted by: Arnfried Walbrecht 

City of Turin decides to 
ditch Windows XP for 
Ubuntu and €6m saving 

€ 6m: the amount the 

municipality of Turin hopes to 
save over five years by switching 
from Windows XP to Ubuntu Linux 
in all of its offices. 

contents ~ 


full circle magazine #89 


NEWS 


The move will mean installing 
the open source operating system 
on 8,300 PCs, which will generate 
an immediate saving of roughly 
€300 per machine (almost €2. 5m 
altogether, made up from the cost 
of Windows and Office licences) — a 
sum that will grow over the years 
as the need for the renewal of 
proprietary software licences 
vanishes, and the employees get 
used to the new machines. 

Or rather, to the old ones. 
Another reason for the switch was 
that the computers Turin uses are 
quite old, and installing Windows 8 
would have probably been too 
demanding for them, whereas 
Linux offers more flexibility with 
more mature machines. And, as the 
support for Windows XP officially 
ended this year, sticking with 
Microsoft didn't make much sense 
to Turin. The switch to Ubuntu was 
officially approved in early August 
and is expected to take around a 
year and a half to complete. 

Source: 

http://www.zdnet.com/city-of- 

turin-decides-to-ditch-windows-xp- 

for-ubuntu-and-6m-savinq- 

7000033482/ 

Submitted by: Arnfried Walbrecht 


Torvalds SAYS HE HAS NO 
STRONG OPINIONS ON 
SYSTEMD 

L inux creator Linus Torvalds is 
well-known for his strong 
opinions on many technical things. 
But when it comes to systemd, the 
init system that has caused a fair 
degree of angst in the Linux world, 
Torvalds is neutral. 

"When it comes to systemd, you 
may expect me to have lots of 
colourful opinions, and I just don't," 
Torvalds told iTWire in an 
interview. "I don't personally mind 
systemd, and in fact my main 
desktop and laptop both run it". 

Source: 

http://www.itwire.com/business-it- 

news/open-source/65402-torvalds- 

savs-he-has-no-stronq-opinions-on- 

systemd 

Submitted by: Sam Varghese 

Everything You Need to 
Know About Meizu MX4, 
the Upcoming Ubuntu 
Phone - Gallery 


T he new Ubuntu Touch 
operating system from 
Canonical will power the new 
Meizu MX4 phone and it will be out 
in December, according to the 
latest information posted by the 
Chinese company. We now take a 
closer look at this new phone to 
see how it will hold up with an 
Ubuntu experience. 

Canonical hasn't provided any 
kind of information about a 
timetable for the launch of the new 
Ubuntu phone from Meizu, and 
even the information that we have 
right now has been posted initially 
on an Italian blog of the Chinese 
company. Basically, no one is saying 
anything officially, but that's not 
really the point. 

The new Meizu MX4 was 
announced just a couple of weeks 
ago and many Ubuntu users have 
asked themselves if this is the 
phone that will eventually feature 
the upcoming Ubuntu Touch. It 
looks like that is the case, so we 
now take a closer look at this 
powerful handset. 

Source: 

http://news.softpedia.eom/news/E 

verythinq-You-Need-to-Know- 


About-Meizu-MX4-the-Upcominq- 

Ubuntu-Phone-458882.shtml 

Submitted by: Silviu Stahie 

Curl Exploits Closed in 
All Supported Ubuntu 
OSes 

anonical has announced that a 
couple of curl vulnerabilities 
have been found and fixed in its 
Ubuntu 14.04 LTS, Ubuntu 12.04 
LTS, and Ubuntu 10.04 LTS 
operating systems. 

The developers have released a 
new update for the curl package 
and it looks like a number of 
security issues have been 
corrected. 

"Tim Ruehsen discovered that 
curl incorrectly handled partial 
literal IP addresses. This could lead 
to the disclosure of cookies to the 
wrong site, and malicious sites 
being able to set cookies for 
others," reads the security notice. 

Source: 

http://news.softpedia.eom/news/C 

url-Exploits-Close-in-All-Supported- 

Ubuntu-OSes-458899.shtml 

Submitted by: Silviu Stahie 

contents ~ 
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Mozilla Thunderbird 
31 . 1.1 Lands in Ubuntu 

C anonical has shared some 
details about a number of 
Thunderbird vulnerabilities 
identified in its Ubuntu 14.04 LTS 
and Ubuntu 1 2.04 LTS operating 
systems, and the devs have pushed 
a new version into the repositories. 

The Thunderbird email client 
was updated a couple of days ago 
and the new version has landed 
pretty quickly in the Ubuntu repos. 
This means that it should be 
available when users update their 
systems. 

For example, "Abhishek Arya 
discovered a use-after-free during 
DOM interactions with SVG. If a 
user were tricked into opening a 
specially crafted message with 
scripting enabled, an attacker 
could potentially exploit this to 
cause a denial of service via 
application crash, or execute 
arbitrary code with the privileges 
of the user invoking Thunderbird," 
reads the announcement. 

Source: 

http://news.softpedia.eom/news/M 

ozilla-Thunderbird-31-1-1-Lands-in- 


the-Ubuntu-458664.shtml 

Submitted by: Silviu Stahie 

Stephen Hawking Talks 
About the Linux-Based 
Intel Connected 
Wheelchair Project 

I ntel has revealed a new, 
interesting concept called the 
Connected Wheelchair, which takes 
data from users and allows people 
to share that info with the 
community and is powered by 
Linux. 

When people say Intel, they 
usually think about processors, but 
the company also makes a host of 
other products, including very cool 
or useful concepts that might have 
some very important applications 
in everyday life. 

The latest initiative is called the 
Connected Wheelchair and the 
guys from Intel even convinced the 
famous Stephen Hawking to help 
them spread the word about this 
amazing project. It's still in the 
testing phases and it's one of those 
products that might show a lot of 
promise but never go anywhere 


because there is no one to produce 
and sell it. 

Source: 

http://news.softpedia.eom/news/S 

tephen-Hawkinq-Talks-About-the- 

Linux-Based-Intel-Connected- 

Wheelchair-Project-458539.shtml 

Submitted by: Silivu Stahie 

Lobbying for open source 
and Linux in schools 

A bout eight years ago, I started 
lobbying to bring more Linux 
and open source software to high 
schools and higher IT vocational 
institutions in the Netherlands and 
Belgium. Here's how I did it and 
what you can learn from it to do 
the same where you live. 

First, Linux and open source in 
education can be categorized into 
three topics: 

• The infrastructure of schools 
• The desktop students and 
teachers work with 
• The curriculum for IT education 

The first topic, the 
infrastructure at schools consists 
of a bunch of different software, 
which is used for administration. 


Examples are applications like 
student management systems, 
document management systems, 
and operating systems. Basically, 
this software isn't that different 
from what is used in other 
industries. This applies not only to 
vocational education, but to all 
schools at any level. 

Source: 

https://opensource.com/education 

/14/9/teachers-linux-open-source- 

education 

Submitted by: Arnfried Walbrecht 


ChromeOS vs Linux: The 
Good, the Bad and the 
Ugly 

A nyone who believes Google 
isn't "making a play" for 
desktop users isn't paying 
attention. In recent years, I've seen 
ChromeOS making quite a splash 
on the Google Chromebook. 
Exploding with popularity on sites 
such as Amazon.com, it looks as if 
ChromeOS could be unstoppable. 

In this article, I'm going to look 
at ChromeOS as a concept to 
market, how it's affecting Linux 

contents ^ 
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adoption and whether or not it's a 
good/bad thing for the Linux 
community as a whole. Plus, I'll talk 
about the biggest issue of all and 
how no one is doing anything 
about it. 

When Folks ask me iF ChromeOS 
is a Linux distribution, I usually 
reply that ChromeOS is to Linux 
what OS X is to BSD. In other 
words, I consider ChromeOS to be 
a Forked operating system that 
uses the Linux kernel under the 
hood. Much oF the operating 
system is made up oF Google's own 
proprietary blend oF code and 
soFtware. 

So while the ChromeOS is using 
the Linux kernel under its hood, it's 
still very diFFerent From what we 
might Find with today's modern 
Linux distributions. 

Source: 

http://www.datamation.com/open- 

source/chromeos-vs-linux-the- 

qood-the-bad-and-the-uqly-1.html 

Submitted by: ArnFried Walbrecht 

Netflix SUPPORT IS 
OFFICIALLY MAKING ITS WAY 


to Linux, finally 

L inux users, you've been very, 
very, very, very, very, very 
patient. And now, your patience is 
being rewarded with NetFlix 
support on your OS oF choice. For 
the longest time NetFlix relied on 
MicrosoFt's would-be Flash 
competitor Silverlight. But, oF 
course, support For the plug in was 
practically non-existent on the 
open-source OS. Now, with 
Silverlight Fading, and NetFlix 
embracing the power oF HTML5, 
your wish oF watching Flicks in your 
Favorite distro (be it Ubuntu, Mint 
or Arch) may Finally come true. Paul 
Adolph From NetFlix posted a 
message to Ubuntu developers, 
telling them that, "NetFlix will play 
with Chrome stable in 14.02 iF NSS 
version 3.1 6.2 or greater is 
installed." 

Source: 

http://www.enqadqet.com/201 4/0 

9/1 9/netFlix-linux/ 

Submitted by: ArnFried Walbrecht 


C hina is developing a 

homegrown operating system 
that could be ready as soon as 
October as part oF an eFFort to 
wean itselF From Western-made 
soFtware, according to a Sunday 
report From the Xinhua 
government news agency, reports 
Technewsworld.com. 

Following hard on the heels oF 
China's announcement last month 
that it had launched an 
investigation oF MicrosoFt under 
the country's antimonopoly laws, 
the latest news suggests the new 
operating system First will appear 
on desktop devices and then be 
extended to smartphones and 
other mobile devices in three to 
Five years. 

The now-deFunct Red Flag Linux 
soFtware could be part oF the new 
OS, according to Computerworld. 

Source: 

http://www.asianaqe.com/technolo 

qy/china-seeks-shun-western- 

soFtware-515 

Submitted by: ArnFried Walbrecht 


China seeks to shun 
Western software 
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Ubuntu gets closer to 
DEBUT IN MEIZU MX4 
PHONE 


T he Ubuntu project announced 
a stable build For Ubuntu 
Touch phones, a week aFter Meizu 
tipped an Ubuntu version oF the 
Meizu MX4 phone due in 
December. 

The Ubuntu For Phones team at 
the Canonical's Ubuntu Project 
announced the arrival oF the First 
image From the ubuntu-rtm 
(release to manuFacturing) 
distribution For phones. The 
announcement Followed last 
week's tease From Meizu, saying a 
version oF the Android-based 
Meizu MX4 was on schedule For 
shipping with Ubuntu in December. 

The RTM image oF Ubuntu 
Touch "seems to be the most 
stable ubuntu-rtm image we ever 
had," writes tukasz 'sil21 00’ 
Zemczak oF the Ubuntu Phones 
team. "Most blockers have been 
resolved (along with the no-input 
unity8 lockup bug), with only more 
minor issues remaining." 

Source: 

http://linuxqizmos.com/ubuntu- 

qets-closer-to-debut-in-meizu-mx4- 

phone/ 

Submitted by: ArnFried Walbrecht 
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Google and Dropbox 
Team on Open Source 
Security 

I n an effort to make open source 
security tools more user friendly, 
Google and Dropbox announced 
Thursday that they have teamed up 
with the Open Technology Fund to 
form "Simply Secure." The goal of 
the new non-profit organization is 
to "help craft usably secure 
technologies and make them 
available for everyone." 

This is the second time this 
week a major technology company 
has launched an open source 
initiative. On Monday, Facebook 
announced its new TODO initiative, 
which is focused on developing 
best practices and tools to support 
open source development 
between companies. Google and 
Dropbox are also participating in 
the TODO collaboration. 

The companies said the 
importance of providing easy-to- 
use secure tools has become 
increasingly important following 
revelations by Edward Snowden 
that the NS A, GCHQ, Unit 2800 and 
other spy agencies penetrated 


numerous technology 
organizations and collected 
personal data from millions of 
people. 

Source: http://www.cio- 
today.com/article/index.php7storv 

id=1 03001 NS30FY 

Submitted by: Arnfried Walbrecht 

Samsung News And 
Rumors: Smartphone 
Running Linux-Based 
Tizen Operating System 
Planned To Debut In 
India, Report Says 

T izen is a Linux-based operating 
system that Samsung already 
uses in some of its cameras and its 
Galaxy Gear line of wearable tech. 
The operating system has wide 
functionality with potential use in 
smart appliances and smart TVs. As 
of yet, Tizen has yet to be used in a 
major smartphone, but Samsung 
may be trying to introduce this 
operating system into its 
smartphone line starting with a run 
in India, according to the report. 

Samsung's current line of Galaxy 


phones and tablets all run using 
Google's Android operating 
system, which also supports 
smartphones from major 
competitors like LG and Motorola. 

If Samsung were able to get a Tizen 
device off the ground, it could 
create a mobile software 
ecosystem to rival Google's 
Android, Microsoft's Windows and 
Apple's iOS, making the gadget 
giant more self-sustaining and less 
dependant on partner companies. 

Source: 

http://www.qamenquide.com/articl 

es/1 3347/201 40923/samsunq- 

news-and-rumors-smartphone- 

runninq-linux-based-tizen- 

operatinq-svstem-planned-to- 

debut-in-india-report-says.htm 
Submitted by: Arnfried Walbrecht 
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COMMAND & CONQUER 

Written by Lucas Westermann 


R ight at the start of September, 

I received an email from a 
long-time reader, who I've had 
previous contact with. The gist of 
the email was that he had written a 
script to search a PDF document, 
and then take each page with a 
match, and create a new PDF of 
only the results. The original 
scenario was that of a law student 
who had to hunt through PDFs that 
were thousands of pages long, but 
I can foresee it being useful for 
others too (students making a 
study guide on a particular topic, 
picking interesting articles out of 
PDFs, etc). As such, this month I 
will be giving a quick run-through 
of how the program works, and the 
technologies/commands it is based 
on. 

The Requirements 

• grep - in package grep (should be 
pre-installed in Ubuntu) 

• pdf info - in poppler-utils (should 
be pre-installed in Ubuntu) 

• pdfunite - in poppler-utils (should 
be pre-installed in Ubuntu) 

• pdftotext- in poppler-utils 
(should be pre-installed in Ubuntu) 

• pdf jam- in pdfjam package in 


Ubuntu, or textlive-extra-utils. 

Most of these commands are 
fairly self-explanatory. The most 
cryptic ones are grep (which is a 
search command for the command- 
line), and pdfjam (which is a shell 
script for merging and splitting 
PDFs). 

The Script 

The most recent copy of the 
script can be found here: 

htt p:// home p aqes.dcc.uf mq .br / ~l c e 

rf / en / utilitie s .html #p df- pa qe- q re p 

(the "download it" link is under 
'Installation'). I will be referencing 
line numbers, so it may be useful to 
download a copy and open it in a 
text editor that offers line 
numbers, in order to follow along. 

If you don't want to include a 
full path every time you search a 
PDF, you can either symbolically 
link it to /usr/bin with: 

sudo In -s /path/to/script 
/usr/bin/pdf-page-grep 

or create a scripts folder in your 


user's home, and then add it to 
your PATH variable. 

How TO USE IT 

• Install the requirements 

• Make the script executable: 

chmod +x /path/to/file 

Make sure to change the path to 
the location you saved the script 
to. 

• Run the script 

— Without arguments to see the 
usage information 

— Run the command based off the 
usage information - such as: 

/path/to/pdf-page-grep -i 
issue* .pdf 

pattern: command & conquer 

OR 

pattern : 

(empty to stop) 

This example would search for 
Command & Conquer (while 
ignoring upper and lower case) in 
all PDFs whose name starts with 
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'issue', and ends with '.pdf' (which 
should cover all copies of FCM, 
unless you rename them). This way, 
you'll end up with a PDF of all C&C 
articles in the issues you've 
downloaded. 

Naturally, there are other 
options you can use (-E for 
extended regular expressions, -F 
for fixed strings, -P for perl regular 
expressions, -w for matching only 
whole words, and -x for matching 
whole lines). 

HOW DOES IT WORK? 

If you open the script up in your 
favourite text editor, you'll notice 
that it's formatted nicely with 
indentations, comments, spacing, 
and a uniform system to loops. The 
first section of the file (lines 1-7) 
would fall under what I class as 
"preamble" - it contains 
information on the author, sets the 
environment at the top for Linux, 
gives information on the license, 
and then sets up the variables used 
later in the file. In this case, the 
only variable used is SUFFIX - 
which, as you might imagine, is the 
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suffix added to the new PDF file 
that contains the matches (default 
value: -matches). 

Lines 9-25 contain an if- 
statement which checks whether 
or not there are any arguments - if 
not, it will then print out the usage 
information. When I write scripts 
such as these, I tend to also include 
a check to see if the argument is "- 
h", and/or compare it to a list of 
accepted arguments. In this case I 
would skip the accepted 
arguments, as you're looking for 
file names, and can hardly have a 
complete list to compare against. 

Lines 27-28 create a temporary 
location for storing the PDFs while 
they're being processed by the 
script (as it converts the PDF with 
pdftotext in order to use grep on 
them). This is an accepted practice 
for keeping the script results clean 
(i.e. not leaving files all over your 
home folder). 

Lines 29-30 uses the trap 
command to empty the temporary 
folder when the script exits 
(including when the script is 
interrupted by the user or system - 
i.e. when you hit ctrl+c). 

Lines 31-44 are a while loop that 


repeatedly asks the user for 
possible search terms, until they 
enter an empty string. Once an 
empty string is entered, it moves 
on in the program. This pattern can 
also be a basic regular expression. 

Lines 46 - 54 is a for loop that 
checks the passed arguments for 
any beginning with a hyphen - as it 
is assumed it indicates an 
argument. If I were the one 
authoring this script, I would have 
opted for an array of acceptable 
options, and searched for them 
instead. If your filename starts with 
a hyphen, I would imagine the 
script would fail. However, it is 
pretty uncommon for a file to be 
named in such a way. 

Lines 56 - 93 is a for loop that 
basically reverses the check from 
lines 46-54 (checks for any 
argument not beginning with a 
hyphen), and assumes it is a 
filename. It then starts a new line, 
prints "matching pages in 
<filename>:<list of pages>". In the 
end you should have a list of every 
PDF searched, as well as a list of 
every page number that matched 
one of your search terms. The last 
two lines will tell you where the 
results were saved, and how many 
matching PDFs were found. The 
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actual search is done by converting 
each page of the pdf to text (using 
pdftotext), and then piping it 
through grep to find the results. If 
there is a match, it will return the 
page number, remember it in the 
variable $sel, and continue to the 
next page. After the for loop of 
pages is complete, it will increment 
the number of matched PDFs (if 
there was a match), extract the 
matched pages into a temporary 
file, reset the list of matched 
pages, and then remember the 
original name of the last matched 
PDF. 

Lines 96-1 01 check if the 
number of matched PDF files 
exists. If not, there were no 
matches, and the program exits. 

Lines 1 02-1 1 2 cover the case of 
one matching file (outputs "1 
matching PDF file", and then 
moves the temporary file into the 
final PDF of results- which avoids 
issues with pdfunite expecting 
more than one file), as well as 
multiple matches. When multiple 
matched PDFs exist, it will use 
pdfunite to merge the files into the 
-matches pdf. 

Line 1 1 3 - This line simply prints 
out the name of the resulting file, 
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so the user can find it. 

I've skimmed over certain 
specifics of the script for two 
reasons - one being brevity, and 
the other being that figuring out 
exactly how a script works simply 
by reading it and running it is a 
good skill to have, especially if you 
plan on writing your own scripts or 
programs. If anyone has particular 
questions about a certain segment 
of the script, you're welcome to 
send me a quick email. If you have 
any other questions, suggestions, 
or requests, you're welcome to 
send me an email at 
lswest34-i-fcm@qmail.com . 



Lucas has learned all he knows From 
repeatedly breaking his system, then 
having no other option but to 
discover how to Fix it. You can email 
Lucas at: lsw e st3 4@qma il.co m. 
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HOW-TO 

Written by Frank Oberle 


Install Oracle on 64-bit Ubuntu 


free -g 


O racle, which provides the 
world's leading Relational 
Database Management System 
(RDBMS), offers a free developer 
license for their product, but 
*buntu users seem to be left in the 
cold. All is not lost, however, 
because in this article I'll show you 
how to install and run the Oracle 
11gR2 Express Edition on 64-bit 
versions of Ubuntu 1 2.04 and 1 4.04 
- this may work for other Debian- 
based systems, but I haven't 
confirmed that. If you are serious 
about becoming a database guru, 
this is an easy way to obtain a 
professional environment in which 
to do so. 

The following will explain how 
to obtain the rpm (Red Hat 
Package Manager) package, 
convert it to a deb package, 
perform the initial set up of Oracle 
XE, and how to begin using 
Oracle's SQL-Plus command-line 
interface. 

There are a few limitations. 
Oracle is suitable only for 64-bit 
*buntu installations. The database 
will be limited to a mere 1 1 GB of 


user data, and is limited to using 
only one processor and no more 
than 1 GB of memory. The 
installation requires at least 51 2 
MB. Details about Oracle XE can be 
seen at: 

http://www.oracle.com/technetwo 

rk/database/database- 

technoloqies/express- 

edition/overview/index.html 

To download the package, you 
will need to create a free online 
account with Oracle - a very small 
price to pay, and, based on my 
experience, one that doesn't result 
in any unsolicited material in your 
in-box. The e-mail and the 
password you select also give you 
access to other developer utilities. 

Throughout these instructions, 
the use of a text editor is required. 
The example commands assume 
the use of gedit, since that is 
Ubuntu's default editor, but you 
can use any text editor you want. 

Step A: You will need to know 
the amount of installed RAM as a 
number of bytes. The easiest way 
to do this is to see the value 
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displayed in "System Settings ..." 
from the desktop, but you may also 
use: 

sudo lshw -short -C memory 

The number must be at least 
51 2 MB; to convert that to an exact 
byte count, use the formula: 51 2 * 

1 ,048,576 = 536,870,91 2 bytes 
(multiply GB by 1 073741 824 to 
obtain bytes) 

Write this number down for 
reference for the later steps. If you 
wish to allocate more RAM to 
Oracle, you may do so, but the 
minimum is usually sufficient for a 
single user running multiple 
applications. 

The remaining commands are all 
issued from a terminal, opened 
with Ctrl+T in Ubuntu. 

Step B: Oracle 11gR2XE 
requires at least 2GB of available 
swap space. Determine if your 
available swap space (in gigabytes) 
is sufficient by issuing the 
following command: 

® 12 


Look for a line similar to the 
following: 

Swap: 13 0 13 

In this example, the machine has 
13 GB available (the third number). 
If you have insufficient swap space, 
you will need to either create a 
swap partition or a swap file. 
Instructions for doing this in 
Ubuntu are readily available on the 
web, and so will not be repeated 
here. 

Pre-Installation Steps 

Step C: Download the zip file 
containing the 64-bit Linux package 
named oracle-xe-1 1 .2.0- 
1 .0.x86_64.rpm by selecting 
downloads from the previous page, 
or by directly choosing: 
http://www.oracle.com/technetwo 

rk/database/database- 

technoloqies/express- 

edition/downloads/index.html 

Step D: Unzip the file using the 
following command: 
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unzip oracle-xe-11 . 2 . 0- 
1.0. x86_64 . rpm. zip 

Step E: If you do not have the 
packages alien, liaiol, and 
unixodbc, you will need to install 
them. Since no harm will be done if 
they are already installed, enter 
the following command: 


sudo apt-get install alien 
libaiol unixodbc 

Step F: Convert the red-hat rpm 
package to an Ubuntu .deb 
package using the following 
command: 


sudo alien — scripts -d 
oracle-xe-11 .2.0- 

1 . 0 . x86_64 .rpm 

Alien takes quite a while to do 
all the required conversions and 
reconfiguring of the rpm package, 
but you can use this time to 
perform all of the steps up to "Step 
M Perform the Installation," but 
don't proceed beyond that until 
the oracle-xe-11. 2.0- 

1.0. x86_64.deb package has been 
created. 

Step G: Create a chkconfig 
script using a text editor: 

The Red Hat installer assumes 


the existence of a file 
/sbin/chkconfig that doesn't exist 
in Ubuntu. Do not load the 
chkconfig package that is available 
for Ubuntu, though, since it can 
cause errors. Instead, create the 
file directly using the following 
commands: 

sudo gedit /sbin/chkconfig 

When the blank file is opened, 
copy and paste the text shown 
above right into the editor. 

Save the file and close the 
editor. 

Step H: Now apply execute 
privileges to the /sbin/chkconfig 
file you just created using the 
following command: 

sudo chmod 755 
/sbin/chkconfig 

You can confirm the settings 
have been applied properly using 
the following command: 

Is -1 /sbin 

You should see: 

-rwxr-xr-x 1 root root 660 
Nov 23 20:29 /sbin/chkconfig 


# ! /bin/bash 

# This file was created for, and only required for the 

# Oracle RDBMS llgR2 XE installation, 
f ile=/etc/init . d/oracle-xe 

if [ [ ! 'tail -nl $file | grep INIT' ]]; then 
echo » $file 

echo ’### BEGIN INIT INFO’ » $file 
echo ’# Provides: OracleXE ’ » $file 

echo ’# Required-Start: $remote_fs $syslog' » $file 
echo '# Required-Stop: $remote_fs $syslog' » $file 
echo '# Default-Start: 2345’ » $file 
echo '# Default-Stop: 0 1 6' » $file 
echo ’# Short -Description : Oracle llg XE ’ » $file 
echo '### END INIT INFO' » $file 
f i 

update-rc.d oracle-xe defaults 80 01 


Step I: Define the Linux Kernel 
parameters 


When the blank file is opened, 
copy and paste the text shown 
below into the editor. 


Oracle 1 1gR2 XE requires the 
setting of some additional kernel 
parameters. First we'll create a 
suitable Oracle configuration file 
using the editor, and then we'll 
make the settings permanent by 
applying them to the kernel so 
they'll be set on each reboot. First 
create the file using the editor. 

sudo gedit /etc/sysctl . d/60- 
oracle . conf 


The value used for 
kernel.shmmax in the last line 
above (536870912) is the minimum 
recommended amount of RAM 
from Step A above. For use of 
Oracle while learning, this is 
probably sufficient, but the value 
may be increased up to the amount 
of RAM in your system if desired 
(i.e. the number does not need to 
match the amount of RAM in your 
system, but it cannot exceed it.) 


# Oracle llg XE kernel parameters 

# Temporary file used for Oracle Installation 
f s . f ile-max=6815744 

net . ipv4 . ip_local_port_range=9000 65000 
kernel . sem=2 50 32000 100 128 
kernel . shmmax=536870912 
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Save the file and close the 
editor. 

Confirm the settings have been 
applied using the following 
command: 


sudo cat /etc/sysctl . d/60- 
oracle . conf 


Step J: Load the Linux Kernel 
parameters 

sudo service procps start 

This command should return: 

me @myMa chine : ~$ procps 
stop/waiting 


Verify the that parameters have 
been loaded by issuing the 
command: 

sudo sysctl -q fs. file-max 

This command should return 
something like the following: 

meQmyMachine : ~$ fs. file-max = 
773266 

Step K: On an Ubuntu system, 
/dev/shm is defined as a link to 
/run/shm, but a link won't satisfy 
Oracle, so the link needs to be 
removed and replaced with an 
actual directory which is then 


mounted. To do so, execute the 
following commands: 

sudo rm -rf /dev/shm 

sudo mkdir /dev/shm 

sudo mount -t tmpfs shmfs -o 
size=2048m /dev/shm 

(The size value can be any value up 
to the size of your RAM in MB, but 
I've found 2048 is quite sufficient). 

To make these changes 
permanent, we need to create 
another file called SOIshmJoad in 
the directory /etc/rc2.d, so another 
editing session is required: 

sudo gedit 

/etc/rc2 . d/S01shm_load 

Copy and paste the text shown 
above right into the editor. 

Save the file and close the 
editor. 

Confirm the settings have been 
applied using the following 
command: 

Is -1 /etc/rc2.d 

There should be an appropriate 
line for the new file similar to the 
following: 
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# ! /bin/sh 

# This file was created for and only required by 

# the Oracle RDBMS installation, 
case "$1 M in 

start) mkdir /var/lock/subsys 2>/dev/null 
touch /var/lock/subsys /listener 
rm /dev/shm 2>/dev/null 
mkdir /dev/shm 2>/dev/null 

mount -t tmpfs shmfs -o size=2048m /dev/shm 

f r 

*) echo error 
exit 1 


t r 

esac 


-rw-r — r — 1 root root 273 

Nov 23 20:41 S01shm_load 

shmfs on /dev/shm type tmpfs 
(rw, size=2048m) 

Now set execute permissions 
for the file with the command: 

Step L: The Red Hat installation 
process uses the /bin/awk utility 
but, since Ubuntu places this at 
/usr/bin/awk, we need to create a 
symbolic link to the location Red 

Hat expects by issuing the 
following command: 

sudo chmod 755 
/etc/rc2 . d/S01shm_load 

Confirm that this was successful 
by repeating the last command: 

Is -1 /etc/rc2.d 

sudo In -s /usr/bin/awk 
/bin/awk 

If successful, the appropriate 
result line should look like this: 

-rwxr-xr-x 1 root root 273 

Nov 23 20:41 S01shm_load 

Create an empty listener 
directory and listener file for 
Oracle's use by issuing the 
following commands: 

Using the mount command, 
confirm that the shmfs temporary 
file system has been loaded by 
looking for a line like the following 
toward the end of the listing: 

mkdir /var/lock/subsys 

touch 

/var/lock/subsys /listener 

DO NOT PROCEED BEYOND 
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THIS POINT UNTIL THE oracle-xe- 
11. 2.0-1 .0.x86_64.deb package 
has been created (see step F). 

Step M: Perform the Installation 

Ensure that you are in the 
directory where the oracle-xe- 
1 1 .2.0-1 .0.x86_64.deb file was 
created in Step F. Begin the 
installation with the following 
command: 

sudo dpkg — install oracle- 
xe_ll . 2 . 0-2_amd64 . deb 

Step N: Remove extraneous 
installation artifact 

By default, the Red Hat 
installation procedure creates a 
desktop start icon, but this won't 
work under Ubuntu, so either 
reconfigure it, or delete it with the 
following command: 

rm $HOME/Desktop/oraclexe- 
gettingstarted . desktop 

Step O: Configure the Oracle 
Installation 

Once installed, Oracle needs to 
be configured prior to using it. The 
utility to do this is run with the 
following command: 


sudo /etc/init . d/oracle-xe 
configure 

You will need to enter the 
following information: 

A valid HTTP port for the Oracle 
Application Express (unless you 
have a good reason for not doing 
so, accept the default value of 
8080 by pressing Enter at the 
prompt) 

A valid port for the Oracle 
database listener (unless you have 
a good reason for not doing so, 
accept the default value of 1 521 by 
pressing Enter) 

A single password for both the 
SYS and SYSTEM administrative 
user accounts; you will be asked to 
re-enter the password for 
confirmation. SAVE THIS 
PASSWORD!! It is for the system 
user "Oracle." 

You will then be asked whether 
you want the database service to 
start automatically each time the 
computer starts. It is most 
convenient to have the service run 
at log-in, so answer "Yes." You'll 
see: 


Step P: Several environment 
variables need to be set up for 
Oracle to run; this is done by 
editing the existing (hidden) 

.bashrc file using the following 
command: 

sudo gedit $HOME/ .bashrc 

Add the lines shown below to 
the end of the .bashrc file: 

Save the file and close the 
editor. Reload your profile by 
issuing the following commands: 

cd $HOME 
. ./.profile 

The command above is "period, 
space, period, slash, period" 
followed by the word "profile." The 


command will only take a second 
to execute and won't display 
anything if it executed successfully, 

Step Q: Start Oracle: 

Depending on whether or not 
you chose the option to have 
Oracle start at boot, the oracle-xe 
service may or may not have 
already been started. Execute the 
following command anyway: 

sudo service oracle-xe start 

If the service has already been 
started, you will receive the 
message: 

Oracle Database llg Express 
Edition instance is already 
started 


Starting Oracle Net Listener. 


######################################################## 

# The following lines were added on mm/dd/yyyy to support 
the use of 

# Oracle llgR02 terminal operations [SQL*Plus] by [Your 
Name] 

export ORACLE_HOME=/u01/app/oracle/product/ll . 2 . 0/xe 
export ORACLE_S ID=XE 

export NLS_LANG= ' $ORACLE_HOME/bin/nls_lang . sh' 
export ORACLE_BASE=/u01/app/oracle 

export LD_LIBRARY_PATH=$ORACLE_HOME/lib: $LD_LIBRARY_PATH 
export PATH=$ORACLE_HOME/bin: $PATH 
######################################################## 
Save the file and close the editor. Reload your profile by 
issuing the following commands: 
cd $HOME 
. ./.profile 
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Otherwise, the following 
message will appear: 

Starting Oracle Database llg 
Express Edition instance. 

Step R: Create a Database User 

For normal activities, you should 
create one or more individual 
database user accounts. To do so, 
execute the following command: 

sqlplus sys as sysdba 

The following message will be 
displayed, confirming that your 
installation has been successful: 

SQL*Plus: Release 11.2.0.2.0 
Production on Wed May 9 
12:12:16 2012 
Copyright (c) 1982, 2011, 
Oracle. All rights reserved. 
Enter password: 

Enter the password you chose in 
Step O:. Assuming you entered the 
correct password, the following 
message will be displayed, 
confirming that your installation 
has been successful: 

Connected to : 

Oracle Database llg Express 
Edition Release 11.2.0.2.0 - 
64bit Production 
SQL> 

It is a good practice to set up 


one or more separate user 
accounts for development and 
experimentation - perhaps even 
one for each project you are 
working on. This will permit you to 
use Oracle without logging out of 
your current user session. As an 
example, you would create a user 
named JohnQ and set his password 
to "Jello" by entering the following 
command: 

create user JohnQ identified 
by Jello; 

The system will respond with: 

User created. 

In order to give JohnQ the 
ability to connect to and use the 
system to create or access a 
database, enter the following 
command: 

grant connect, resource to 
JohnQ; 

You may or may not wish to add 
other permissions to that list, such 
as dba, depending on your needs. 
The system will respond with: 

Grant succeeded . 

Repeat this process to create 
any other users that may be 


needed at this time. 

Step S: Log in as a User and 
Confirm Operations 

The following command will 
disconnect you from the SYS 
account, and connect you to 
JohnQ's account to confirm that 
your user setup was successful: 

sqlplus JohnQ/ Jello 

If you simply type "sqlplus" 
alone, SQL*Plus will prompt for a 
user id and password. A minimal 
method of confirming that the 
database is operational is to 
execute the following command: 

select sysdate from dual; 

The system will return 
something that looks like the 
following: 

SYSDATE 

5-JUN-14 

Uninstalling Oracle 

To completely uninstall the 
Oracle RDBMS, execute the 
following commands from a 
terminal: 


sudo -s 

/etc/init . d/oracle-xe stop 

sudo ps -ef | grep oracle | 
grep -v grep | awk ’ {print 
$2}’ | xargs kill 

sudo dpkg — purge oracle-xe 

sudo rm -r /u01 

sudo rm /etc/default/oracle- 
xe 

sudo update-rc.d -f oracle-xe 
remove 

Remove the following files that 
are no longer needed: 

sudo rm /sbin/chkconfig 

sudo rm /etc/sysctl . d/60- 
oracle.conf (may not exist) 

sudo rm 

/etc/rc2 . d/S01shm_load 

Remove the lines previously 
added to the end of 
$HOME/.bashrc in Step P. This will 
prevent any warning messages 
about non-existent files from 
appearing when starting a shell. 

Remove the symbolic link to 
awk: 

sudo In -s /usr/bin/awk 
/bin/awk 
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Empty and then remove the 
/var/lock/subsys directory: 


Python Special Editions: 


sudo rm -Ir /var/lock/subsys 
sudo rmdir /var/lock/subsys 



Frank is the author of the book 
"Business Database Triage" and is 
currently working on the follow-up 
book, "Business Database Design - 
Class Notes from Aristotle's Lyceum". 



http://fullcirclemaqazine.org/issue-pv01/ http://fullcirclemagazine.org/issue-pv02/ 



http://fullcirclemagazine.org/pvthon- http://fullcirclemaqazine.org/pvthon- 

special-edition-issue-three/ special-edition-volume-four/ 



http://fullcirclemagazine.org/pvthon- http://fullcirclemagazine.org/python- 

special-edition-volume-five/ special-edition-volume-six/ 
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Written by Elmer Perry 


B ack in parts 8-1 2 (FCM issues 
53, 55-58), I took you from a 
blank spreadsheet to a full working 
budget spreadsheet. Something 
similar is what I use twice a month 
to do my home budget. I keep a 
whole year of budget spreadsheets 
in one document, which means 
twice a month I copy the sheet, 
rename it, and make sure I get all 
the settings correct to put a copy 
of the current sheet at the end of 
the sheet tabs. Believe me, 
mistakes have been made. Curses 
have been breathed. Innocent 
computers have been threatened. 


In time, I decided, since I was 
such a fallible, flawed human 
being, I needed to reduce the 
number of steps necessary to 
complete this task in order to 
lessen my chances for mistakes. 
The result was a macro where all I 
have to do is give the sheet a new 
name. The macro handles all the 
rest, making sure it is copied and 
placed at the end of the tab list. 
The task fits perfectly into the idea 
behind macros, a repeatable 
process that automation can speed 
up, or prevent mistakes. Today, I 


LibreOffice Pt.41 - Copy Sheet Macro 


share it with you. 

The Manual Method 


o 
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In order to appreciate a macro, 
you really have to understand what 
it's doing for you, and the mistakes 
you can make. Therefore, I will start 
with the description of the manual 
process that the macro makes 
simpler. There is actually more than 
one way to copy a sheet in Calc, but 


I will show you the dialog method 
with all the options. 

Right-click on the tab of the 
sheet you want to copy and select 
Move/Copy Sheet. The Move/Copy 
dialog appears. You then select 
Copy. One of the mistakes I have 
made is to forget this. I end up just 
renaming my sheet. Under "Insert 
Before" select the option at the 
end "-move to end position-". If I 
forget this one, the sheet is placed 
before the current sheet rather 
than at the end where I want it. 
Finally, I have to rename the sheet. 
There have been times while trying 
to remember to get the other 
settings right, that I have forgotten 
to actually change the name. When 
I do, the copied sheet gets the 
name of the current sheet with a 
"_2" appended to the end. Click OK 
to execute the settings. 

I know, you're thinking that it's 
not that bad, but after a few times 
getting it wrong, your inner Hulk 
comes out and you want to smash 
things. Okay, maybe that's just me. 
Trying to balance the home budget 
is frustrating enough without the 


bonus of mistakes while copying 
the spreadsheet. 

The CopySheet Macro 

The macro is not very long (next 
page, top right) and you can easily 
type it in. You can also copy it from 

http://pastebin.com/s3iTGiN6 . 

The micro starts by declaring 3 
variables used in the body of the 
macro. "Sheetl" and "Sheet2" are 
strings that will contain the names 
of the current sheet (Sheetl) and 
the new sheet (Sheet2). The "Doc" 
variable will hold a reference to the 
current document. It is declared as 
a type Object because the 
reference is to a LibreOffice API 
object. 

Doc = ThisComponent 

ThisComponent is the current 
active document in LibreOffice. In 
this case, the macro is looking for a 
Calc spreadsheet. 

If NOT 

Doc . support sService ( "com. sun . 
star . sheet . SpreadsheetDocumen 
t " ) then 
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MsgBox "This Macro Only 
Works with Calc Spreadsheets" 
Exit Sub 
End If 

The "If" statements check to 
make sure that the current 
document is a Calc spreadsheet. It 
checks to see whether the 
document supports the 
SpreadsheetDocument service, 
identifying it as a Calc spreadsheet 
and not some other document 
type. If it is not a spreadsheet, the 
macro pops up a message box 
telling the user the macro works 
only with spreadsheets. The macro 
then executes an "Exit Sub" that 
exits the macro without running 
any more of the code. 

Sheet 1 = 

Doc . CurrentController . ActiveS 
heet . Name 


The macro uses the Doc object 
to extract the name of the current 
sheet. The breadcrumb dot 
notation goes through a 
progression of getting more 
specific. CurrentController is a 
reference to the service that 
controls the document. 
ActiveSheet is a reference to the 
currently active sheet in the 
document. Finally, Name gets the 
name of the current sheet and this 


Sub CopySheet 

dim Sheet 1 as String 
dim Sheet2 as String 
dim Doc as Object 
Doc = ThisComponent 

If NOT Doc . support sService ( "com. sun . star . sheet . SpreadsheetDocument" ) then 
MsgBox "This Macro Only Works with Calc Spreadsheets" 

Exit Sub 
End If 

Sheet 1 = Doc . CurrentController .ActiveSheet .Name 

Sheet2 = InputBox ( "Enter Name for Copied Sheet : " , "Copy Sheet", Sheetl) 

If Sheet2 = "" Then Exit Sub 
Do While Doc . Sheets . hasByName (Sheet 2) 

Sheet 2 = InputBox (Sheet 2 + _ 

" already exists, select a different name:", "Copy Sheet", Sheet2 + "2") 
If Sheet2 = "" Then Exit Sub 

Loop 

Doc . Sheets . CopyByName (Sheetl , Sheet 2 , Doc . Sheets . Count) 

End Sub 


is assigned to the variable Sheetl. 

Sheet2 = InputBox ( "Enter Name 
for Copied Sheet:", "Copy 
Sheet " , Sheet 1 ) 

To get the name of the new 
sheet, the macro uses an InputBox 
function. The InputBox takes 3 
arguments: 

• The prompt to show the user 
("Enter Name for Copied Sheet:"). 

• The title of the InputBox window 
("Copy Sheet"). 

• The default text (it just uses the 
name of the current sheet [Sheetl] 
as the default text). 

If the user clicks the OK button, 


the InputBox will return the string 
entered in the text box or the 
default text when no changes are 
made. If the user clicks the Cancel 
button, a blank string is returned. 

If Sheet 2 = "" Then Exit Sub 
Do While 

Doc. Sheets .hasByName (Sheet2) 
Sheet2 = InputBox (Sheet 2 

+ _ 

" already exists, select 
a different name:", "Copy 
Sheet", Sheet 2 + "2") 

If Sheet2 = "" Then Exit 

Sub 

Loop 

Now, the macro must use some 
logic to determine how to proceed. 
The "If" checks to see if the 


returned string is blank. If so, that 
means that the Cancel button was 
pressed, therefore the "Exit Sub" is 
executed. "Exit Sub" exits the 
macro without running any more of 
the remaining code. 

The Do While...Loop checks to 
see if another sheet in the Calc 
document has the same name. The 
hasByName method checks the 
supplied name against the names 
of all the sheets in the collection. If 
a match is detected, the macro 
uses an InputBox to prompt the 
user for a new, unmatched name. 
The Do While...Loop will loop until 
the name in Sheet2 does not match 
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the name oF any other sheet. The 
"IF" inside the loop exits the macro 
iF Cancel is pressed. IF the name is 
unmatched From the start, the loop 
never runs. This prevents two 
sheets From having the same name. 


NOTE: The underscore (J in the 
InputBox statement is used to 
break a long line up into shorter 
lines. LibreOFFice Basic requires 
that the underscore is the last 
thing on the line. Nothing, not even 
a space, can Follow it. When lines 
are joined in this way, LibreOFFice 
Basic sees them as one line. 


Doc . Sheets . CopyByName ( Sheet 1 , 
Sheet 2 , Doc . Sheet s . Count ) 

The last line oF the macro brings 
all this preparatory work together 


B o. 


Macro name 

COft'Sh-eet 

Macro from 

My Macros 

* NH Standard 

4 E3 

j? Learnino 
$ writ-er 

* iM- Writer 

* 1 Lib - e-oFFice Macros 

> £] audoet^oi A ods 

> j£| lO 41 Cnpy SKe=t Macro.ndt 


to Finally execute the copy. Sheets 
is a reFerence to the collection oF 
sheets in the document. 
CopyByName is the method that 
actually copies the sheet and 
moves it to the end oF the sheet 
tabs. The CopyByName method has 
3 parameters: 

• The sheet to copy From (Sheetl). 

• The sheet to copy to (Sheet2). 

• The position oF the new sheet 
(Doc.Sheets.Count). 

Count is the total number oF 
sheets in the collection (Sheets). 
Since the sheet numbers are 
reFerenced starting with 0, the use 
oF Count here puts the new sheet 
at the end. 

Creating the Calc Macro 
Module 


_ arES^CE fiasic Macros 


Existing macros in: Cak 


£jui 


£. ; nsc 


High ghtFw-n 


Assign 


□eLetc 


When I developed and wrote 
the CopySheet macro, I created a 
macro module For Calc. Here I 
could store this macro as well as 
any Future macros designed For the 
Calc program. It's a good idea to 
group like macros together. 

To create the module, Tools > 
Macros > Organize Macros > 
LibreOFFice Basic. The LibreOFFice 
Basic Macros dialog opens. Click 
Organizer to get the LibreOFFice 
Basic Macro Organizer dialog. 
Under My Macros > Standard, there 
is a deFault module named Module 
1 . Select it and click Delete. With 
Standard selected, click New. 

Name the new Module "Calc" and 
click OK. Click Close. 



Now back in the LibreOFFice 
Basic Macros dialog, select the new 
"Calc" module you just created and 
click Edit, opening the LibreOFFice 
Macro Editor. Delete the 
automatically created "Sub Main" 
and "End Sub". Type in or copy and 
paste the SheetCopy macro into 
the editor. Save the module and 
close the editor. 

Test The Macro 

AFter typing in the macro and 
saving it, you will want to test it to 
make sure you typed everything 
correctly. First, open a Calc 
document or create a new one. You 
can then test the macro by going 
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B c 

| Macro Selector 

_ □ X 

1 Select the library that contains the macro you want Then select the metro under 'Macro name'. 

Run 

1 Library 

M 


£*ncel 



* 0 ^ M icroi 


j 




[#] Standard 


HighLi phtEwen 

Help 



*■ m 



— 
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to Tools > Macros > Run. Under 
Library, select My Macros > 
Standard > Calc. Under "Macro 
Name" select CopySheet and click 
Run. Enter a name For the sheet 
like "New Sheet." Click OK. IF all 
goes well, a new sheet is created 
with the name you gave it. You will 
want to repeat the test and not 
change the name to see iF the 
macro prompts you to change the 
name. Also, test to make sure the 
macro stops when you click on 
Cancel rather than OK. For the Final 
test, open a text document and run 
the macro. You should get the 
message telling you that the macro 
works only on spreadsheets. 


Macros like CopySheet can 
speed up your processes and 
prevent you From making mistakes, 
which is the whole idea behind 
macros. This is just an example oF 
something you can do with macros, 
but you can write your own macros 
that can expand the use or 
capabilities oF any oF the 
LibreOFFice programs, or just 
reduce a task you do oFten. A 
Google search For "LibreOFFice 
Basic" is a good place to start 
learning more. 


NOTE: Back in Full Circle issue 64 
(LibreOFFice Part 17: Macros), I 
showed you how to create a menu 
shortcut to a macro. This is a good 
candidate For such a shortcut. 
Create the menu and shortcut in 
Calc. 



Elmer Perry's history of working, and 
programming, computers involves an 
Apple ][E, adding some Amiga, a 
generous helping of DOS and 
Windows, a dash of Unix, and blend 
well with Linux and Ubuntu. 

He blogs at 

h ttp://e eperry.wordpre ss.co m 
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uk podcast 



The Ubuntu Podcast covers all 
the latest news and issues Facing 
Ubuntu Linux users and Free 
SoFtware Fans in general. The 
show appeals to the newest user 
and the oldest coder. Our 
discussions cover the 
development oF Ubuntu but 
aren’t overly technical. We are 
lucky enough to have some great 
guests on the show, telling us 
First hand about the latest 
exciting developments they are 
working on, in a way that we can 
all understand! We also talk 
about the Ubuntu community 
and what it gets up to. 

The show is presented by 
members oF the UK’s Ubuntu 
Linux community. Because it is 
covered by the Ubuntu Code oF 
Conduct it is suitable For all. 

The show is broadcast live every 
Fortnight on a Tuesday evening 
(British time) and is available For 
download the Following day. 

podcast.ubuntu-uk.org 
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EXTRA! EXTRA! 

READ ALL ABOUT IT! 

Our glorious news reporters 
are now posting regular news 
updates to the main Full Circle 
site. 

Click the NEWS link, in the site 
menu at the top oF the page, 
and you'll see the news 
headlines. 

Alternatively, look on the right 
side oF any page on the site, 
and you'll see the Five latest 
news posts. 

Feel Free to discuss the news 
items. It's maybe something 
that can spill back From the site 
into the magazine. Enjoy! 
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HOW-TO 

Written byAlessio Ciregia 


• • multimedia and amusement: 
games, image editing and video 
playback 

• • personal and home income 
management 

• • office software 

• and for professional use, it seems 
something strictly related to 
information technology, like 
something made by programmers 
for other programmers or IT staff: 

• • network tools 

• • web server and stuff like that 

• • programming languages and 
development tools 

• • anything strictly related to IT, 
computer science, network and so 
on 


Disclaimer 

Maybe this article is not 
intended for a wide range of 
people reading this magazine, as I 
will describe the installation of a 
niche software related to the 
medical and health-care enterprise 
world. 

It is not a home software; 
indeed nobody has a positron 
emission tomography (PET) facility 
at home, have they? 


M aybe I'm wrong, but reading 
magazines like this, I have 
the feeling that Ubuntu, Linux and 
FOSS in general are mainly 
perceived, by common people, as 
something related to or useful for: 
• a hobby for geeks, computer 
enthusiasts and programmers 
• a free and legal way to achieve, 
using a PC, day by day personal 
interests (an alternative to 
Windows and paid software) and 
tasks such as: 


• • and at last something related to 
business 

But there are other aspects of 
Linux and FOSS: the real world, the 
serious things. Like health care 
applications, as stated above. 

So, in this article I will explain 
how to install dcm4chee on 
Ubuntu. Maybe, as I said before, no 
reader of this magazine will have 
the need or the knowledge to 
install and understand this 


software, but if you are a student, 
or if you know a dentist or a 
radiological study, maybe you 
could be inspired by knowing the 
existence of this software. 


PACS (Picture archiving and 
communication system) is a 
medical imaging technology which 
provides storage of and access to 
images from multiple modalities. 


DICOM AND PACS 

DICOM (Digital Imaging and 
Communications in Medicine) "is a 
standard for handling, storing, 
printing, and transmitting 
information in medical imaging". 


A modality is a source machine 
where patient's images are 
acquired from, for example, an X- 
Ray machine or a Magnetic 
Resonance scanner. Some other 
actors of a PACS are: servers, 
storage (NAS, SAN, tapes), printers, 
viewers, CD/DVD robots, etc. 
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dcm4che.or g 

dcm4chee 

(http://dcm4che.org/) is a DICOM 
archive and image manager, that is 
the server side oF a PACS system, 
the server where medical images 
(an x-ray, an ultrasound, a magnetic 
resonance) will be stored, and Prom 
which a radiologist will retrieve 
your examination in order to carry 
out a medical report. 

"The application contains the 
DICOM, HL7 services and interfaces 
that are required to provide storage, 
retrieval, and workflow to a health- 
care environment". It is written in 
Java and is prepackaged and 
deployed within the JBoss 
application server. It is open source 
and licensed under an 
MPL/GPL/LGPL triple license. There 
are also a lot oF DICOM related 
tools provided by the same 
developers and community (called 
dcm4che toolkit), and some DICOM 
viewers, like Mayam, Oviyam and 
Weasis. 

IP you need help and assistance 
there is a Google group where a 
vibrant and nice community will be 
willing to give you some advice. On 


the other hand, the wiki lacks a 
little bit in documentation, that is 
some pages are dated or are 
incomplete. 

Let's install it 

Even if some willing person has 
packaged dcm4che in a ".deb" 
package, and even if I'm a lover oF 
package management systems, in 
this case I Feel better iP I install this 
soPtware by hand. 

So, let's see how to install 
dcm4chee on Ubuntu server 14.04 
LTS. 

First oP all we need to install 
Java. I'm not sure iF dcm4chee 
works with OpenJDK. And I'm not 
sure iF it works with Java 1 .7, so 
let's install Oracle Java 1 .6, using a 
PPA repository. 

sudo apt-get install 
software-properties-common 

sudo add- apt-repository 
ppa : webupd8 1 earn/ j ava 

sudo apt-get update 

sudo apt-get install oracle- 
java6-installer 

We need to accept the license, 
and so on. 


dcm4chee needs a database: 
Postgres, DB2, Oracle, MySQL, etc. 
IP you want to try it without a 
RDBMS, you can opt For the HSQL 
package, but let's install MySQL. 

sudo apt-get install mysql- 
server 

Now we need to create a 
schema and grant all rights to a 
user. 

$ mysql -uroot -p***** 

mysql> create schema pacsdb; 

mysql> grant all on pacsdb.* 
to pacs@localhost identified 
by ’ pacs ’ ; 

mysql> flush privileges; 
mysql> \q 

Now we need to download 
JBoss and dcm4chee zip Files. 
Download JBoss 4.2.3.GA (don't 
use a newer version!) Prom 

http://sourceForqe.net/proiects/ib 

oss/Pi les/JBoss/J Boss- 

4.2. 3.GA/iboss-4.2.3.GA- 

idk6.zip/download 

Download the latest release oP 
dcm4chee-mysql, 2.18.0 at time oF 
writing, From 


http://sourcePorqe.net/proiects/dc 

m4che/Files/dcm4chee/ 

Put the zip Piles in a temporary 
Polder, like /var/tmp/dcminstall and 
unzip them 

sudo apt-get install unzip 

unzip dcm4chee-2 . 18 . 0- 
mysql . zip 

unzip jboss-4 .2.3. GA- jdk6 . zip 

Since we are on a 64-bit 
operating system, and the 
dcm4chee zip File contains a 32-bit 
version oF compression library, we 
have to download the proper Java 
Advanced Imaging Image I/O Tools 
For linux 64-bit Prom 
http://download.iava.net/media/iai 

-imaqeio/builds/release/1 .1 / and 

replace the Linux version oP 

libclib iiio.so 

wget 

http : //download. java . net/medi 
a/ jai- 

imageio/builds/release/1 . 1/ ja 
i_imageio-l_l-lib-linux- 
amd64 .tar .gz 

tar xzvf jai_imageio-l_l-lib- 
linux-amd64 . tar . gz 

cp 

/var/tmp/install/ jai_imageio- 
l_l/lib/libclib_jiio . so 
/var/tmp/install/dcm4chee- 
2.18.0- 
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mysql/bin/native/libclib_jiio 
. so 

Now we have to copy files from 
JBoss to Dcm4chee: 

cd /var/tmp/install/dcm4chee- 

2.18. 0- mysql/bin/ 

. /install_jboss . sh 
/var/tmp/ install/ jboss- 
4 . 2 . 3 . GA 

Now we have to import the 
provided SQL file in order to create 
the database tables and indexes: 

cd /var/tmp/install/dcm4chee- 

2.18. 0- mysql/ sql/ 

mysql -upacs -ppacs pacsdb < 
create .mysql 

And now we have to move the 
dcm4chee directory to a definitive 
place, like /opt, and then it is useful 
to create a symbolic link (so, in case 
of an upgrade, we don't need to 
modify any script or anything else 
pointing to the dcm4chee 
directory): 

cd / 
sudo mv 

/var/tmp/install/dcm4chee- 

2.18. 0- mysql/ /opt/ 

sudo In -s /opt/dcm4chee- 

2.18. 0- mysql /opt/dcm4chee 


It is a good idea to create a 
dcm4chee user and change the 
owner of the installation dir. 

user add dcm4chee 

chown -R dcm4chee 
/opt/dcm4chee-2 . 18 . 0-mysql 

Now we can try to run 
dcm4chee in foreground: 

su - dcm4chee -c 
/opt/dcm4chee/bin/run . sh 

Using a web browser, connect 
to 

http://yourubuntuserver:8080/dcm 

4chee-web3 


The default user is "admin" and 
the default password is "admin". 

In order to make changes to the 
default configuration, we need to 
use the JBoss jmx console 
http://yourubuntuserver:8080/jmx- 

console/, and this task could be 
painful since there are no manuals 
covering a step-by-step 
configuration: you have to dig 
inside the wiki and on the old 
forum or, as I said before, you can 
call for help in the mailing list. 


More info: 

• wiki - 

http://www.dcm4che.org/confluen 

ce/displav/proi/The+Project 

• mailing list - 

https://qroups.qooqle.com/forum/ 

m/?hl=en#!forum/dcm4che 

• discontinued forum - 
http://forums.dcm4che.org 



Alessio is an unpretentious sysadmin 
at FTGM, a specialist 
cardiopulmonary health foundation 
in Italy. Linux and FOSS are not his 
hobby... they are a job. Sometimes he 
blogs at h ttp://b loqole ss.b loqspot.it 
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GIMP - Perspective Clone Tool 



HOW-TO 

Written by Ronnie Tucker 


N icholas is absent this week, so 
I thought I'd step in and show 
you a much overlooked, yet 
powerful, feature in GIMP: 
Perspective Clone. 

Cloning will take what's under 
your source and copy it to a 
destination. That's 'create' for 
making two of you in one photo, 
but what if the cloning involves 
perspective. That is: smaller in the 
distance and larger in the 
foreground. 


I'll use this photo as a reference: 



Perspective is chosen: 


[fffl] Tool Options 

Perspective Clone 

© Modify Perspective 

Perspective Clone 


0 


Now click on the image and 
adjust the corner boxes to align 
with the perspective of the image: 



Now that GIMP knows the 
perspective of the building choose 
Perspective Clone from the Tool 
Options: 



First, click the 
Perspective Clone tool 
(shown left). 


Perspective Clone 

Modify Perspective 


In the Tool Options tab (usually 
on the left), make sure Modify 


o Perspective Clone 


Now, like you would with Finally, draw where you want to 

normal cloning, hold down CTRL to I clone to. Simple as that! 
choose your source and click. 



AFTER 
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Inkscape - Part 29 



HOW-TO 

Written by Mark Crutch 


L ast time I introduced Inkscape's 
notion of clones - duplicate 
objects that maintain a link to their 
parent. I also demonstrated that 
clones can be independently 
transformed whilst still 
maintaining that link, so you can 
set the basic shape, Fill and stroke 
on a parent object, but then 
additionally skew, scale and rotate 
the clone. Keep that capability in 
your mind, as we'll be returning to 
it later in this article, but First I 
need to talk to you about cloning 
groups. 

It's possible to clone almost any 
type oF object in Inkscape. 
Previously I used rectangles, text 
and images, but the same rules 
apply to stars, spirals and paths. 
The exception is 3D boxes, which 
don't behave at all well when 
cloned, and tend to disappear 
when the parent is modified. You 
can 'ungroup' a 3D box to convert 
it into normal paths; iFyou then 
group those together again, you 
can clone that group, but you'll 
have lost the ability to edit the 
parent using the 3D Box tool. 


Whether created From a 3D box, 
or via any other mechanism, groups 
are a prime target For cloning. 
Having drawn a complex object 
made up of several different parts, 
it's useful to be able to clone it in 
its entirety, rather than having to 
clone each part separately. Let's 
use this technique to create a clone 
army using the snowman we last 
saw in part 14. 



The parent object here is the 
snowman at the Front, which has 
been cloned multiple times, and 
the clones scaled. The parent is a 
group which contains other groups 
- one For the hat, one For each arm, 
and so on. It's only when you drill 
down a couple of levels deep that 
you Finally get to real paths and 
shapes, but cloning a group 


automatically includes all of that 
structure, no matter how deep it 
goes. 

Creating lots of clones like this 
can be time consuming, but there 
are a couple of tricks to speed up 
the process. The First is to use 
Inkscape's Tiled Clones Feature 
(Edit > Clone > Create Tiled 
Clones...) which is a hugely 
powerful, but extremely 
complicated, tool. I'll be covering 
some aspects of it later in this 
series. The other approach - and 
the one I took here - is to create 
the First clone, then drag it around 
the screen, 'stamping' it in place by 
pressing the spacebar. Each copy 
that you stamp is a duplicate of the 
object you're dragging, and, as we 
Found out last time, a duplicate of 
a clone retains a link to the original 
parent object. By working From the 
back to the Front, pausing 
occasionally to re-scale the clone 
that's being dragged, it took only a 
Few moments to create all the 
clones in the image. 

One big problem with clones is 
that they can appear too similar. 


Our clone army loses some menace 
through all being exactly identical, 
right down to their arm positions. 
One way to deal with this is to 
break your group apart into smaller 
sections, and clone them 
separately. For example, if we 
break the snowman apart to 
separate his hat, arms, pipe, scarf 
and nose From the main group, we 
can create an army with a little 
more individuality by simply 
omitting or transforming them on 
some of the characters. 



This technique is one that I use 
Frequently when creating comic 
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strips. A character's body is often 
cloned directly from one panel to 
the next, but the arms or legs are 
cloned separately so they can 
'move' between scenes to add a 
little dynamism to the strip. Often 
I'll also scale and crop the clones, 
to give the impression of a camera 
zooming into or out of the scene. 
Don't forget that you can still draw 
extra elements on top of your 
clones to truly make each one 
individual. That's how I deal with a 
cloned character that may be 
speaking in one panel and silent in 
another: the original parent has no 
mouth, then it's drawn on the 
clones separately for each scene. 

When cloning a group, it's 
important to realise that the clone 
is not a group itself. You can't 
enter the clone to make changes. 
You can, of course, still enter the 
parent and make changes there. 
They will propagate to the clones 
as usual. When dealing with 
groups, though, you not only have 
the option of changing fills, 
strokes, filters and 
transformations, but also the 
possibility to delete objects in the 
group, or create new ones. Even 
those changes will propagate to 
the clones, offering up one rather 
nice way to use clones which isn't 


immediately obvious. 

For this technique, we'll need a 
group. Ideally it would be empty, 
but Inkscape won't let you create 
an empty group, so we'll have to 
put something in it. A good starting 
point is to draw a large square, 
almost filling the canvas, with a 
stroke but no fill. Then immediately 
group it using the icon on the main 
toolbar, the Object > Group menu, 
or by pressing CTRL-G. Select the 
square and check the status bar: it 
should confirm that you've got a 
group of one object. 

With the group selected, press 
ALT-D to clone it. With the clone 
now selected, press the 'H' key, 
select the Object > Flip Florizontal 
menu, or use the toolbar button to 
mirror the clone horizontally. You 
shouldn't see any obvious change 
as you've mirrored it directly on 
top of the parent. Next, send the 
clone to the back of the Z-order 
using the toolbar button, Object > 
Lower to Bottom, or by pressing 
the END key. Finally, double-click 
on the parent (remember, it's now 
at the top of the Z-order, so you 
can just double-click on its stroke) 
to enter the original group. Now 
switch to the Pencil or Calligraphy 
tool and draw something. 


If you've set everything up 
correctly, you should find that each 
time you release the mouse 
button, the line you've drawn is 
immediately reproduced as a 
mirror image at the opposite side 
of the canvas. All that's actually 
happening, of course, is that the 
objects you're adding to your 
group are being reflected (in every 
sense) in the clone of the group. 
Because the square you drew has 
no fill, the clone shows through as 
a mirroring of your every stroke. 



You're not limited to the Pencil 
and Calligraphy tools, of course. 
Anything you draw, regardless of 
the tool (except the problematic 
3D boxes, of course) will be 
mirrored, making it a useful way of 
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making symmetric designs. It's 
surprising how readily a few 
random paths will become a 
person, alien, insect or plant once 
you introduce a little symmetry, 
making it a great way to get 
started when inspiration has left 
you. 

As soon as you have drawn 
another object in the group, there's 
no need for the square any more, 
so delete it if you wish. I prefer to 
leave it in place for reference until 
I've finished drawing, then remove 
it as a final step. Either way, don't 
feel constrained by it - the square 
is only there to provide some initial 
content for the group, so don't be 
shy about drawing beyond its 
limits. 



HOWTO -INKSCAPE 


Once you've got the hang of the 
basic technique, it shouldn't be 
hard to see that extending it to 
three clones lets you create 
drawings that are mirrored both 
horizontally and vertically. 

Flipping the clones like this is a 
good start, but why not try other 
transformations on them? Rotating 
them is a great option and holding 
down CTRL to lock the rotation to 
the Fixed steps defined in 
Inkscape's preferences can quickly 
produce kaleidoscopic effects. Try 
setting different opacities for each 
group, or blurring some of them. 
Within a few minutes, you'll be 
creating works of abstract 
computer art with just a couple of 
squiggles of the mouse. 

This example was made by 
rotating the original square about 
its bottom right corner. By moving 
the center of rotation for the 
original, it was already in the 
correct place as each clone was 
created. Then I simply cloned the 
original group and rotated it whilst 
holding CTRL. I reduced the opacity 
and increased the blur a little. 
Pressing CTRL-D created the next 
clone, and the cycle was repeated 
until I had completed a full circle of 


clones. Bringing the original to the 
front, double clicking on it, then 
drawing a single shape with the 
Pencil tool (with the Shape control 
set to "Ellipse") produced this 
abstract image, spiralling away to 
nothingness. 



Any changes you make to filtered 
elements will still be stored, saved 
and applied if you export a bitmap 
- they just won't show up on 
screen. Use View > Display Mode > 
Normal to see the page in its fully 
rendered glory. You can press 
CTRL+5 (on the numeric keypad) to 
cycle through the view modes, 
including the "outline" mode which 
is great for finding rogue elements 
that have become invisible due to 
too much blurring or too low an 
opacity. This is a useful shortcut to 
learn if you find yourself plagued 
by slow redraws as you can press it 
at any time - even in the middle of 
a redraw - if you don't need to see 
the fully Filtered version of the 
image for the particular edit you're 
making at the time. 


If you do try this technique and 
decide to use blurring on your 
clones as I have done here, you'll 
soon find that Inkscape can slow 
down to a crawl. It's not just 
blurring that has this effect - any 
of Inkscape's filter Functions can 
result in the rendering engine 
having to perform copious 
calculations, slowing it down 
considerably. If you Find this to be a 
problem, you can try turning off 
the display of filters using the View 
> Display Mode > No Filters option. 
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Whether you're creating swirly 
patterns or armies of characters, 
there will come a time when you 
want to break the link between a 
clone and its parent. Perhaps your 
snowman needs a completely 
different smile to its comrades, or 
your soft, pastel spiral needs a 
single bright red segment to draw 
the eye. What you really want is a 
copy of the parent object that you 
can modify as much as you want 
without being constrained by that 
pesky linkage. 

I 29 


You could, of course, just create 
a copy as normal, but if you've 
already got a clone in the right 
place, it seems a shame not to use 
it. The Edit > Clone > Unlink Clone 
menu item will do what you want, 
turning any selected clone into a 
plain, old fashioned copy. Use it 
wisely because although it's easy 
to convert a clone into a copy, you 
can't go back in the opposite 
direction. 




Cs 

Mark uses Inkscape to create three 
webcomics, 'The Greys', 'Monsters, 
Inked' and 'Elvie', which can all be 
found at 

h ttp://w ww.peppertop.com/ 
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Arduino 



HOW-TO 

Written by Ronnie Tucker 


L ast month was a merge of two 
sketches into one which 
resulted in keypad presses being 
displayed on an LCD screen. This 
month I'm keeping the same circuit 
but adding more code. 

Welcome! 

I thought it'd be nice if the 
Arduino could take the keypad 
input and check it against a known 
password. Well, there just happens 
to be a handy dandy library called 
Password. You can grab it from: 
http://playqround.arduino.ee/Code 

/Password . 

As it says on the page, 
download, unarchive and copy the 
folder to your sketches library 
folder. Now you can use 

#include <Password . h> 

in your code. 

Merging the code wasn't going 
so well for me until I found this 
example: 


https://sites.qooqle.com/site/ardui 

nomeqa2560proiects/home/level- 

3/keymembrane-and-lcd-password- 

lock . This is pretty much what I 
wanted to achieve - but with my 
3x4 keypad. 

After much tinkering, I managed 
to get it working. One thing that 
did catch me out for a while was 
the include statements. Apparently 
you shouldn't put things between 
the include statements. I had the 
Password("4321") line right below 
the Password include, but before 
the LiquidCrystal include, so that 
stumped me for a bit. Once I got 
past that, I got stumped with why it 
wouldn't accept the password. 
After much trial and error I found 
that in the line: 

case ’ ’ : guessPassword() ; 

break; 

the "case ' '" statement is 
effectively the 'enter' key for the 
password. So, changing the ' ' to '#' 
worked a treat. After that I tidied 
up the before and after screens. 

Now it says 'Enter code:'. You 
enter a four digit code and press 
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the hash key (#) to finish. The LCD 
screen will either say 'INVALID 
PASSWORD', pause, and return to 
the 'Enter code:' screen, or it will 
say VALID PASSWORD', pause, 
display 'Welcome!', pause, then 
return to the 'Enter code:' screen. 

My code is at: 

http://pastebin.com/V0f9GBFf . 

Now, wouldn't it be nice if it 
stopped at 'Welcome!' and waited 
for something to happen before 
needing a code or something...? 



Ronnie is the founder and (still!) 
editor of Full Circle. He's a part-time 
arts and crafts sort of guy, and now 
an Arduino tinkerer. 
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HOW-TO 

Written by Ronnie Tucker 


Guidelines 


document. 


T he single rule for an article is 
that it must somehow be 
linked to Ubuntu or one of the 
many derivatives oF Ubuntu 
(Kubuntu, Xubuntu, Lubuntu, etc). 

Rules 

• There is no word limit for articles, 
but be advised that long articles 
may be split across several issues. 

• For advice, please refer to the 
Official Full Circle Style Guide: 

http://url.fullcirclemaqazine.org/75 

d471 


• Write your article in whichever 
software you choose, I would 
recommend LibreOffice, but most 
importantly - PLEASE SPELL AND 
GRAMMAR CHECK IT! 

• In your article, please indicate 
where you would like a particular 
image to be placed by indicating 
the image name in a new 
paragraph or by embedding the 
image in the ODT (Open Office) 


• Images should be JPG, no wider 
than 800 pixels, and use low 
compression. 

• Do not use tables or any type of 
bold or italic formatting. 

If you are writing a review, 
please follow these guidelines : 

When you are ready to submit 
your article please email it to: 

artides@fuUcirdemaqazine.org 

Translations 

If you would like to translate 
Full Circle into your native 
language please send an email to 
ronnie@fulldrdemaqazine.orq and 

we will either put you in touch with 
an existing team, or give you access 
to the raw text to translate from. 
With a completed PDF, you will be 
able to upload your file to the main 
Full Circle site. 


Write For Full Circle Magazine 


REVIEWS 

Games/Applications 

When reviewing games/applications please state clearly: 

• title of the game 

• who makes the game 

• is it free, or a paid download? 

• where to get it from (give download/homepage URL) 

• is it Linux native, or did you use Wine? 

• your marks out of five 

• a summary with positive and negative points 

Hardware 

When reviewing hardware please state clearly: 

• make and model of the hardware 

• what category would you put this hardware into? 

• any glitches that you may have had while using the hardware? 

• easy to get the hardware working in Linux? 

• did you have to use Windows drivers? 

• marks out of five 

• a summary with positive and negative points 


You don't need to be an expert to write an 
article - write about the games, applications 
and hardware that you use every day. 
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xJ Access all your data in one de-duplicated location 
Configurable multi- platform synchronization 
xJ Preserve all historical versions & deleted files 

Share folders instantly in web ShareRooms w / RSS 
xJ Retrieve files from any internet-connected device 
i O Comprehensive 'zero-knowledge' data encryption 
xJ 2 GBs Free / $10 per 100 GBs / Unlimited devices 


https://spideroak.com 



Online Secure 

BACKUP SYNC 


SHARING 


Whether you need to access a document you have stored 
on a remote server, synchronize data between a Mac, 
Windows or Linux device, share important business 
documents with your clients, or just rest easy knowing all of 
your data is safely, securely, and automatically backed up - 
SpiderOak's free online backup, online sync and online 
sharing solution can handle all your needs! 

SpiderOak offers a different approach to online backup by 
combining a suite of services into one consolidated tool - 
free online backup, synchronization, sharing, remote access, 
and storage. This difference is further measured in our zero- 
knowledge privacy policy - the first one ever employed in 
this setting. Our flexible design allows you to handle data 
from any operating system (Mac, Windows and Linux) or 
location (external drives, network volumes, USB keys, etc...) 
using just one centralized account. 


Download mobile clients 

for iOS & Android J 




JOIN SPIDEROAK NOW 


Get 2 Free GBs 






Get 25% off any SpiderOak package 
with the code: FullcirclemagFans 


LINUX LAB 

Written by Charles McColm 


Kodi/XBMC Part 1 1 Hardware 


I t was way back in Issue #56 that I 
last wrote about XBMC for Full 
Circle Magazine. Back then, we 
were running XBMC on Ubuntu 
1 0.04. We're now a couple of Long 
Term Support (LTS) releases ahead. 
Back in Issue #56, our XBMC 
machine was a Dell Inspiron Mini 10 
netbook (250GB internal hard 
drive) with a 1TB external hard 
drive for our media storage. 

Later we tried going even 
smaller, installing both the 
Android+XBMC and a custom 
firmware+Linux+XBMC distribution 
on a Pivos XIOS DS Media Play 
device. The custom firmware+Linux 
XBMC solution was wicked fast. 

The small device had lots of 
positives, built-in wireless, 3 USB 
ports, its own remote control, low 
power consumption, and it could 
be hidden behind our TV, but it had 
lots of drawbacks too. The minimal 
version of Linux for the XIOS DS 
lacked some of the flexibility we 
had on the Ubuntu Linux + Inspiron 
Mini 1 0 solution. Storage was 
minimal (we had a small microSD 
card). Adding more storage meant 
either connecting an external hard 


drive or setting up a NAS 
somewhere (more power and 
cables). And we wanted a bit more 
CPU power! 

Coincidentally, about this time 
the 1TB hard drive started 
displaying SMART errors so we 
bought a 2TB hard drive. The larger 
hard drive triggered our desire to 
go bigger and badder so we added 
a bit more equipment: 

An Antec Sonata II case, an Asus 
P5K SE motherboard, an Intel 


Pentium D processor at 3GHz with 
4GB of RAM, and a 320GB hard 
drive for the boot drive. 

For a short time we used the 
same solution we used for the 
netbook - a VGA cable and a 
separate sound cable to hook up to 
our 42" Samsung LCD Television. 
We're fortunate that our LCD 
television supports VGA as well as 
FIDMI. One of the nice things about 
the Pivos XIOS DS setup was the 
fact that both the audio and video 
went over the FIDMI cable to our 


television. We like things nice and 
tidy and using the VGA cable 
meant we had to run a second 
cable for audio. 

A couple of weeks later we 
picked up an NVidia GeForce 210 
1 GB video card. We got the card on 
an open box special. The sales 
person cautioned us that the card 
was meant for multimedia, not 
gaming. We just smiled and took 
the generous discount. The card 
has 3 common video connections: 
VGA, DVI and FIDMI. Only FIDMI 
supports video and audio. 

Around the same time the 
XBMC project released a version of 
Ubuntu+XBMC called XBMCbuntu. 
XBMCbuntu simplified a lot of 
things we had to install manually 
before (it installed proprietary 
video drivers, SAMBA, already had 
support for our Windows Media 
Centre remote control - which 
works nicely if you use lircd, etc.). 
XBMCbuntu came in an AMD and 
an NVidia flavour. It worked very 
well except for the fact that it 
failed to get the correct Extended 
Display Identification Data (EDID) 
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LINUX LAB 


for our television. XBMC displayed 
just fine at 1 920x1 080 (over the 
HDMI cable, the VGA cable we 
originally used limited us to 
1 366x768) but if you quit XBMC 
and ran the underlying Openbox 
you could barely read anything on 
the screen. 

Several software upgrades later 
we managed to get XBMC to 
version 13 (Gotham) but because 
we used XBMCbuntu we were 
stuck with Ubuntu 1 2.1 0. With 
Ubuntu 1 2.1 0 sorely out of date 
and XBMC heading towards release 
14 and it's new name, Kodi, we 
decided it was time to upgrade and 
change again. 

The argument for the Kodi 
name was partly rooted in the fact 
that XBMC doesn't run on any 
XBox other than the original 
machine (and barely at that). While 
we're not aware of Microsoft 
exercising any trademark 
infringement actions against the 
XBMC team, the possibility was 
always there. Over the years XBMC 
has become much more than just a 
media centre, it streams, it can 
game, and can be a PVR front end. 
The Kodi name change is part of a 
larger move towards changing the 
XBMC image from just a media 


centre to an entertainment centre. 

All this newness lead us to 
realize our XBMC machine is a bit 
of a dinosaur - outdated software, 
and hardware we'd been using for 
quite a long time. Ideally we would 
have used something like this: 
http://ca.pcpartpicker.eom/p/8KFm 

23 

For our ideal build we went Intel 
over AMD because our experience 
with NVidia for video drivers is 
generally better than AMD, but it's 
worth noting here that last year we 
built an AMD APU-based system 
that has worked wonderfully as a 
desktop system using Kubuntu and 
Xubuntu. That system had the 
following parts (plus a 250GB hard 
drive and a Blueray player we 
already had): 

http://ca.pcpartpicker.eom/p/bGvD 

n£ 

The PC Part Picker web site is a 
handy way to piece together a 
system for do-it-yourselfers and 
has a US and UK version, just add us 
or uk in front of the url 
(uk.pcpartpicker.com for example). 

Our budget was a lot less than 
$900 (the Intel system), and we 
could get some used upgrades we 


could trust for a lot less. So we 
started by upgrading parts and 
including one of the parts in our 
list, the 3TB hard drive. 

The first change: Our aging 
Pentium D processor. Changing 
motherboards would have meant 
investing in a new motherboard, 
CPU and DDR3 RAM. What we had 
with our Socket 775-based 
motherboard was working well for 
us. We just wanted to squeeze a bit 
more power out of the system, so 
we picked up an Intel Core 2 Quad 
Q8300 @ 2.50GHz (4 Cores) 


processor. Our original Pentium D 
clocked in a bit quicker at 3GHz, 
but after changing to the 4 core 
Q8300 we noticed the movies 
scrolled by better on the selection 
screen. It was a noticeable 
difference. 

Next we focused on our 2TB 
data hard drive. The drive was 
more than half full and we'd 
recently moved a bunch of data on 
to the 320GB operating system 
drive to free up more space, so we 
picked up an inexpensive 3TB 
Seagate drive. 
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Both the operating system drive 
and the 2TB hard drive are Seagate 
drives. And while our First Seagate 
1TB started showing smart errors 
after about 1 year the 2TB and 
320GB drives have run well For a 
couple of years. 

The new drive posed a bit of a 
problem because we're using older 
hardware that doesn't natively 
support GPT in the BIOS. Linux 
does support GPT, but it took some 
poking around to figure out how to 
partition and mount the drive. 

Initially we tried setting up the 
drive using: cfdisk /dev/sdc. Cfdisk 
seemed to see all 3TB and when 
we formated the drive it appeared 
like it was going to get detected as 
3TB, but when we rebooted we 
noticed it showed up as 768GB, a 
fraction of the size. We kept 
looking and found a solution on 
Buildcube: 

http://www.buildcube.com/tech bl 

oq/2012/07/25/instaUinq-mv-3tb- 

hard-drive-on-debian-linux-step-bv- 

step / 

Initially we were a bit crazy and 
formatted our drive using NTFS. 
The 2TB hard drive was already 
NTFS so we thought we'd do the 
same For the 3TB, but later we 


decided against it and went ext4. 
It's worth noting that we found 
ext4 took up less space - 77MB 
versus the 160MB NTFS used. 
We're including both methods 
here. 

sudo apt-get install parted 
sudo parted /dev/sdc 

The previous command puts us 
in parted. Parted is a bit like the ex 
editor, it waits for us to give it 
commands. We'll give it the 
command to make a GPT label 
instead of an MBR label (2TB max). 

mklabel gpt 

Answer yes to the warning that 
data will be destroyed (assuming 
your drive was /dev/sdc -- ours 
actually was), don't accidentally 
delete a drive/data you need. 

mkpart primary ntfs 0% 100% 
quit 

This sets up the drive as gpt and 
gets it set for formatting, now we 
just need to format the drive: 

sudo mkfs.ntfs -Q /dev/sdcl 


-Q switch and go NTFS, expect to 
wait a long time. 

At this point we stopped being 
silly and repeated the process with 
the Following modifications to 
make the drive a writable ext4 
drive: 

sudo parted / dev/ sdc 
mklabel gpt 

mkpart primary ext 4 0% 100% 
quit 

sudo mkfs.ext4 /dev/sdcl 

One of the problems we ran 
into when we mounted our new 
ext4 drive was that we couldn't get 
it writable by the xbmc user 
account. Permissions are always 
fun. To fix the problem, we created 
a directory under /mnt called 
/mnt/movies and changed the 
owner to the xbmc user: 

sudo chown -R xbmc. xbmc 
/mnt/movies 

The period between the xbmc's 
differentiates user and group. If 
you wanted a different group you 
would use something like: 

sudo chown -R xbmc .multimedia 
/mnt/movies . 


The -Q in the NTFS version does 
a quick Format. If you don't use the 
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Now we needed to get our new 
hard drive into /etc/fstab so it 
would be mounted automatically. 
Several years ago the mounting 
method in /etc/fstab switched to 
UUID's making it a bit more 
complex; luckily we have blkid to 
tell us the UUID of each drive. We 
simple ran: 

sudo blkid 


Our results looked like this: 

/dev/sdal : UUID="9ce53713- 
9bcd-4df 4-al60-e93826eefb2f " 
TYPE="ext4 " 

/dev/sda5: UUID="db9cf246- 
0e50-4a95-bec0-6ad63e91e20d" 
TYPE=" swap" 

/ dev/ s db 1 : LABEL= " dat a " 
UUID="4D07684A289AEA37" 
TYPE="ntfs" 

/dev/sdcl: UUID="a6732b72- 
ef 69-4129-88e6-ed328d8c8786" 
TYPE="ext4 " 

The line we added to /etc/fstab 
was: 

UUID=a6732b72-ef69-4129-88e6- 
ed328d8c8786 /mnt/movies 
ext4 defaults, noatime 

0 1 

If we were doing NTFS, it would 
have been something like (note the 
UUID changes when Formatted 
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with NTFS: 

UUID=1011D1F75957D63A 
/mnt /movies ntfs 
error s=remount-ro 0 

To test our entry was working 
correctly, without rebooting we 
mounted all the drives in fstab: 

sudo mount -a 

Then we ran df -hH to see the 
sizes: 

Filesystem Size 

Used Avail Use% Mounted on 


/dev/sdal 

311G 

31G 266G 

11% / 

udev 

2.2G 

13k 2.2G 

1 % / dev 

tmpfs 

424M 

697k 423M 

1% /run 

none 

5.3M 

0 5 . 3M i 

0% /run/lock 

none 

2.2G 

4.1k 2.2G 

1% /run/ shm 

none 

105M 

0 105M i 

0% /run/user 

/dev/sdbl 

2 . IT 

1.2T 834G 

59% /data 


/dev/sdcl 3.0T 

77M 2 . 9T 1% /mnt/movies 

Success! We kept our initial 
install of XBMCbuntu temporarily 
so we could focus on the hardware. 

Hardware-wise we were 
(almost) done for now. Next issue 
we'll be installing Linux+XBMC and 
all the services for remote control 
support and sharing within the 
house. But, just before we close, 
one final hardware change we 
made was to upgrade our home 
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network a small bit. Since we 
would be moving large files (one 3- 
hour movie in Blueray-quality was 
around 1 2GB), we added a gigabit 
switch to our internal network to 
speed things up a bit. 

Before mounting all the 
networking equipment we took 
pieces of paper and outlined each 
piece of equipment and their 
mounting holes. We then taped 
those outlines to the mounting 
board and put screws in the place 
each piece of equipment would 
mount. In the case of our small 
VOIP box, we needed to run 
hanging wire across it to keep it in 
place because it intended to sit on 
top of something rather than be 
mounted on a wall. 

Next issue, the Linux and XBMC 
install. 



Charles is the author of Instant 
XBMC, and project manager of a not- 
for-profit computer reuse project. 
When not building PCs, removing 
malware, and encouraging people to 
use GNU/Linux, Charles works on 
reinventing his blog at 
h ttp://w w w.ch arles mcco l m.co m. 
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Written by Alan Ward 


Compiling A Kernel - Part 2 


I n the First part oF this series, we 
saw what the Linux kernel is, and 
its place within a GNU/Linux 
operating system. We ended up by 
giving several reasons why a user 
oF a modern operating system 
could still wish to compile his or 
her own kernel, centering our 
remarks speciFically around the 
Ubuntu distribution. In this second 
chapter, we will consider the 
various ways oF obtaining the 
source code For the kernel, explore 
its directory structure and see 
what other pieces we need in order 
to compile it. 

GETTING THE KERNEL 
SOURCE 

As usual with the Ubuntu 
distribution, the kernel source is 
available in a single soFtware 
package From the command-line 
apt commands or your Favorite 
graphical soFtware manager. 
Basically, what we need to install is 
a single package, "linux-source". 
This is a meta-package that points 
to whatever is the latest version oF 
the kernel source in the 


repositories. So, in a terminal, go 
into administrator mode with: 

$ sudo bash 

and then reFresh the package 
lists beFore downloading the 
kernel source. The reFresh is 
important because kernel source 
packages do get updated From 
time to time, and the release 
version numbers can change. 

# apt -get update 

# apt-get install linux- 
source 

At the time oF writing, the 
3.13.0 kernel needed to download 
97.7MB oF Files. This is installed as 
a single compressed File in 
directory /usr/src/linux-source- 
3.1 3.0 - or with whatever version 
number you have downloaded. 
Switch directories to there 

# cd /usr/src/linux-source- 
3.13.0 

and unzip the compressed File 
using the bunzip2 utility. The bzip 
compression algorithm gives 
better compression than the more 


common gzip, though at the 
expense oF greater complexity. So 
do not be surprised iF 
decompression takes some time! 

IF it is not present on your 
system, you will First need to 
download and install the bzip 
utility programs: 

# apt-get install bzip2 

# bunzip2 linux-source- 

3.13.0. tar .bz2 

# tar xf linux-source- 

3.13.0 . tar 

We should now have a 
subdirectory also called linux- 
source-3.1 3.0, into which we 
change directories once more: 

# cd linux-source-3 . 13 . 0 

It can be oF help to create a 
direct link to the more recent 
kernel source tree, especially iF we 
have more than one version: 

# In -s /usr/src/linux- 
source-3 . 13 . 0/linux-source- 
3.13.0 /usr/src/linux 

and now /usr/src/linux points to 


the real directory at /usr/src/linux- 
source-3.1 3.0/linux-source-3.1 3.0. 
We can also do some cleaning up oF 
the compressed Files, iF we need 
them no more. 

An alternative way oF getting 
the kernel source is to simply get it 
From the kernel.org project 
archives. This ensures that we get 
the very latest kernel version, and 
also that we have access to release 
candidates oF the next, Future, 
version. At the time oF writing, 
Ubuntu's kernel source version is 
3.13.0, but kernel.org has already 
gone up to 3.1 5.4, and the next 
version's release candidate is at 
version number 3.16. 

A word oF warning may be 
appropriate, however: kernels that 
are not From the current stable 
version have not undergone the 
whole process oF testing. They will 
include new Features, and may 
possibly break your installation. IF 
you do not need to test these 
Future versions, it is best to stay 
with the stable ones. 

On the other hand, several 
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older stable versions of the kernel 
source are also available at 
kernel.org; at the time of writing 
going back down to 2.6.32. It 
should be noted that these earlier 
versions have been updated with 
bug corrections and security 
updates since they came out; what 
is missing from earlier versions is 
merely the new features that have 
come out in newer versions. 

These older versions may come 
in handy, either to replicate the 
behavior of a system with an 
earlier configuration, or because a 
certain application needs a kernel 
from an earlier series. For example, 
an old hardware driver module 
available in source code may need 
a kernel source from the 2.0 series 
in order to compile correctly. These 


are probably fringe cases, however, 
and will rarely be seen by most 
users. 

Once downloaded, the 
compressed source file must be 
decompressed and un-tarred as 
with Ubuntu's packaged version. In 
this case, the tar file is compressed 
using XZ compression, a version of 
the popular 7-zip encoding from 
the Windows world. We will not 
need to install any further utility 
programs, tar itself can 
decompress this format. We can cd 
to wherever we downloaded the 
compressed file, transfer it to the 
/usr/src directory and uncompress 
it: 

# cp 

/home/alan/Downloads/linux- 
3.15.4. tar . xz /usr/src 


# cd /usr/src 

# tar xf linux-3 . 15 . 4 .tar .xz 

This produces the linux-3. 15.4 
subdirectory, with the source files 
inside. 

DIFFERENCES 
BETWEEN SOURCES 

So far, we have obtained not 
one but two different kernel 
source trees. The first, from the 
Ubuntu repositories, contains the 
structure shown below (top). 

The second source tree, directly 
from the kernel.org project 
website, is below (bottom). 

So they are basically the same 


tree structure, with a single 
difference: the "ubuntu" 
subdirectory. This is not a surprise, 
since the Ubuntu package is 
supposed to come originally from 
kernel.org, though some re- 
packaging may have taken place. 
We can confirm this by looking at 
how much space is occupied by 
each version: 

# du -sh * 

626M linux-3. 15. 4 

634M linux-source-3 .13.0 

Ubuntu's version is slightly 
larger - even though it contains an 
earlier kernel version. This 
confirms that Ubuntu has in fact 
altered the kernel in some way. 

The differences are what Ubuntu 
calls the "Ubuntu patches" to the 
kernel. The interested reader will 
find more information on Ubuntu's 
Kernel Team and what they do on 
their wiki page: 

https://wiki.ubuntu.com/Kernel 

EXPLORING THE 
SOURCE DIRECTORY 
STRUCTURE 

When we take a look at the 
source code directory tree, the first 
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# cd /usr/src 

# Is linux 

arch Documentation 

include 

kernel 

net 

security virt 

block 

drivers 

init 

lib 

README 

sound 

COPYING 

dropped . txt 

ipc 

MAINTAINERS 

REPORTING-BUGS 

tools 

CREDITS 

firmware 

Kbuild 

Makefile 

samples 

ubuntu 

crypto 

f s 

Kconf ig 

mm 

scripts 

usr 


# Is linux-3. 15. 4 
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drivers 

ipc 
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REPORTING-BUGS 

tools 

COPYING 

firmware 

Kbuild 

Makefile 

samples 

usr 

CREDITS 

f s 

Kconfig 

mm 

scripts 

virt 

crypto 

include 

kernel 

net 

security 
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thing we see are several text Piles 
immediately at the tree root. As 
always, README is a great place to 
start. This Pile contains some quick 
instructions to get you up and 
running. However, some parts are 
slightly outdated, Por example 
rePerring to the LILO boot manager 
that is little used nowadays, and 
not at all on Ubuntu distributions. 
The CREDITS and MAINTAINERS 
Piles contain a list oP people who 
have contributed to the kernel 
code and some oP the parts they 
have been responsible For. The 
perusal oP these two Piles can give 
us a perspective of how the kernel 
is in Pact the product oP a team oP 
programmers working together. 
Linus Torvalds and Greg Kroah- 
Hartman are perhaps the best- 
known participants and project 
leaders, but they are by no means 
alone. 

The Documentation directory is 
a large and not very well 
structured collection oP mainly 
(very) technical notes. Most oF the 
material here relates to speciFic 
hardware and procedures setup in 
the kernel, and unFortunately will 
be oP little help to the beginner. 

The other directories are the 
kernel source code. The very basic 


stuPF, mostly related to process 
scheduling and control, is in a 
directory named kernel. Other 
important parts are broken out 
into diFPerent directories: Ps (File 
systems), ipc (inter-process 
communication), mm (memory 
management), net (networking), 
sound (sound drivers), etc. 

Several directories handle 
speciPic hardware needs. In the 
First place, the arch directory was 
created to contain low-level code 
to handle each type oP architecture 
supported by the kernel. This is the 
only place where you should Find 
assembly code instead oP the C 
language. Having the very large 
majority oP the code in C helps the 
kernel be adapted to diFPerent 
hardware platPorms when needed: 
most C code will not need to be re- 
written, but simply compiled For 
the new physical architecture. On 
the other hand, each speciPic 
platform may need some very low- 
level coding just to take care oP 
initial kernel booting. IF you take a 
look in this directory, you will 
appreciate the diversity of 
hardware platPorms supported by 
the Linux kernel. You will Find not 
just the Intel 32-bit Architecture 
IA32 under x86 and AMD 64-bit 
architecture under ia64, but also 
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11 br $ 29 , 2 f 
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well-known names such as alpha 
(the DEC Alpha processor), 
powerpe (the Intel-Apple-Motorola 
PowerPC), spare (Sun's SPARC), and 
more modern architectures such as 
arm (the 32-bit ARM Family used in 
tablets and phones) and even 
arm64 (the newer 64-bit version oP 
the ARM). 

Another important directory is 
drivers. Together with the sound 
directory (containing speciPic 
drivers For sound processing 
hardware) and several other minor 
directories, here is where you 
would see the drivers For each type 
oP hardware the kernel supports. 
Basically, iP there is code in this 
directory that knows how to 
handle your piece oP hardware, it 
may work in a GNU/Linux system. 


Otherwise, things may get really 
complicated to get it to Function. 

Please bear in mind that each 
piece oP driver code in this 
directory does not address any 
particular brand or make oP 
hardware, but rather the controller 
chips used in that device. For 
example, in directory 
drivers/net/ethernet/realtek we 
can Find a Pile called 81 39cp.c. This 
device driver handles any Ethernet 
network card using the RealTek 
RTL-8139C+ series controller, 
which at the time was used by 
many different card 
manufacturers, and sold under 
probably more than 100 different 
brand names. Some versions were 
used in exchangeable PCI-interPace 
cards, while others were soldered 
directly into computer's 
motherboards. But all can use the 
same driver code developed 
initially (as was much of the 
network interface code) by Donald 
Becker, as is mentioned in the C 
Pile's initial commentary section. 

The Firmware directory is the 
other place where we will Find bits 
of code that are not written in the 
C programming language. A 
modern computer can in some 
ways be seen as a multicomputer 
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network: the main computer hands 
off some of the work to daughter 
systems: the sound processing 
system, the graphics card, the 
network card, a hard drive, a 
printer, etc, are all formed by small 
computing environments, each 
controlled by a micro-controller 
acting as a small CPU in its own 
right. Firmware is a concept that 
comes from the introduction of 
non-volatile memory in both in 
domestic electronic apparatus and 
in internal computer components. 
These daughter systems now have 
the capability of running not only 
programs that were written once 
and for all in ROM chips, "engraved 
in stone" so to speak, but can also 
load programs on the fly into 
various forms of re-writable 
memory (EE-PROM or "Flash" 
memory). This memory on the 
daughter board contains programs 
in binary form, destined not for the 
computer's CPU but for the micro- 
controller of each apparatus or 
component. 

To initialize and use some of 
these devices, we will need not 
only a device driver - which is a 
program run by our computer's 
CPU and resident in its own 
memory - but also a piece of 
firmware - known as a "binary blob" 



- that must be loaded into the 
device's memory on initialization. 
These are not considered as part of 
the kernel itself. 

There has been some dispute 
about the nature of the firmware 
included with the Linux kernel. 
Some distributions, such as Ubuntu 
itself, have little qualms about 
including firmware that is not 
open-source or released under the 
GPL license. Their take is that the 
end-user wishes simply to have 
things work; since they have 
acquired the hardware, they must 
also have access to the software 


necessary to make it function. But 
there is also the contrary 
standpoint, proposed notably by 
Richard Stallman and adopted by 
distributions such as gNewSense, 
that argues that proprietary and 
non-open binary blobs may work, 
or not. They may work particularly 
well in some cases, and fail 
miserably in others - and for 
reasons unknown. Since nobody 
except the manufacturer has 
access to the source code, there is 
no way of assessing the firmware 
code, making it better, or adapting 
it to new needs. It is for this reason 
that the kernel.org project 
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members take pains to trace the 
origins of binary blobs distributed 
with the kernel, as may be seen in 
file firmware/WHENCE. It is also for 
this reason that distributions such 
as Ubuntu or Linux Mint permit the 
installation of certain non open- 
source drivers, but only at the 
user's initiative and specifying 
clearly they come without any 
support from the distribution's 
team. 


glteuiSensc 


WHAT ELSE DO WE 
NEED? 

Once we have the kernel source 
decompressed on our disk, we will 
need several things in order to 
compile it. Naturally, we will need 
the C language compiler, but that 
will not be all. 

For the readers who may need a 
quick primer on the process of 
compilation, let us begin by 
describing some concepts. In order 
to compile a program written in a 
compiled programming language, 
in the first place we will need the 
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program itself, or what is called the 
source code. This is simply a text 
file that contains the program 
instructions, though the extension 
will have been changed to ".c" to 
mark it as a C source code file, and 
not a file containing mere text. We 
will now follow with a short 
example of a C program, contained 
in a file named "hello.c". This is 
perhaps the best-known example 
of C programming, that almost all 
programmers will have seen at 
some point: 

#include <stdio.h> 

#include <stdlib.h> 

int main ( int argc , char 
*argv [ ] ) { 

printf ("Hello, 
world! \n" ) ; 

> 

The first two lines indicate we 
wish to include several header files. 
These contain no code properly 
speaking, but just the definition of 
several function interfaces (such as 
"printf"). If we include them, the 
compiler will suppose these 
functions are available when 
reading in ("parsing") our program 
file. The program's main body - the 
"main" function - contains just one 
single line, instructing the system 


compiled language 
(e.g. C) 



to print a character string on 
screen. 

In order to actually execute this 
program, we will need to translate 
the complete program into an 
executable or binary file. This 
process is what is known as 
compilation. 

Readers of Greg Walters' 
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interpreted language 
(e.g* Python) 


source code 


! no executable 


interpreter 


y e xe cu ted indi recti y , 

* through interpreter 

"Programming in Python" series in 
these very same pages will have 
noted that no such translation 
process is needed for the Python 
programming language. This latter 
belongs to the class of 
"interpreted languages"; the 
programs produced in an 
interpreted language are not 
executed directly, but rather 
interpreted instruction-by- 


instruction on the fly by a program 
called - you guessed it! - an 
interpreter. In the case of compiled 
languages such as C, however, no 
such interpreter exists, and so we 
need to convert the source code 
into an executable file before 
getting to test our program and 
knowing if it actually works. 

Both approaches have benefits 
and drawbacks. By using compiled 
languages, we get an executable 
file that can run very fast, and the 
end user will only need access to 
this single file. On the other hand, 
interpreted languages will give the 
end user access to the source code, 
which he or she can modify and 
tune to their needs. But they 
would need to have an interpreter 
for that particular language 
installed on their system, and the 
end result executes a tad more 
slowly. 

To compile our test "hello.c" 
program, supposing we have the 
gcc C language compiler installed 
on our system (if not, we will need 
to install package "gcc"), we can 
issue: 

$ cc hello.c -o hello 

This tells the C language 
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compiler ("cc", get it?) to compile 
source code Pile "hello.c", 
producing executable Pile "hello". 
Note that in the UNIX and 
GNU/Linux world, executable Piles 
need not have the ".exe" 
extension. Once the Pile is 
compiled, the resulting executable 
can be executed by issuing: 

$ ./hello 
Hello , world! 

Naturally, things can get a little 
more complex when a large 
application project contains several 
hundred C and header Piles. In the 
case oF the Linux kernel, not all oP 
these are always to be compiled - 
depending on which target 
architecture (Intel 32-bit 
Architecture, IA64, ...) we are 
compiling For. To simplify things, a 
Pile containing instructions on what 
to compile, in which order, and 
using which compilation 
parameters, can be drawn up. This 
makefile can be seen as a pattern 
or guide For the compilation 
process. 

Going back to our sample 
program, we could write the Pile 
"Makefile" with the Following 
contents: 


hello: 

cc hello.c -o hello 

Now, each time we wish to 
compile the Pile, we could use the 
make command to run the file 
contents For us: 

$ make hello 

and the corresponding instructions 
From the makefile would be 
executed. 

As you might suspect, both the 
compiler and the make-build 
environment are largely used in 
order to simplify the Linux kernel 
compilation process. This is why we 
will need to have installed not only 
the C compiler itself, but also 
several utility programs: GNU make 
itself, a bzip decompressor, etc.. 
The following packages will be 
needed at some point in the 
process: 

gcc binutils make bzip2 
coreutils 

The kernel compilation process 
may be configured to a certain 
extent using the makefile system. 
To do so, several configuration 
scripts are available. The simplest, 
invoked by issuing: 


$ make config 

is a simple text-based script that 
needs no Further software to work. 
However, the two graphical 
configuration utilities: 

$ make xconfig 

and 

$ make gconfig 

rely respectively on the qt and gtk 
widget frameworks developed 
originally for the KDE and Gnome 
desktop managers. In the first case, 
"xconfig" will need to have the 
following packages installed: 

qt 4 -de f aul t qt 4 -qmake 

If using the gtk version, 
"gconfig" will need packages: 

libgtk2 . 0-dev libglib2 . 0-dev 
libglade2-dev 

Finally, my preferred way of 
configuring the kernel is using the 
curses-based 

make menuconfig 

This text-based but more user- 
friendly environment will need the 
following package: 
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ncurses-dev 

Now that we have all the bits 
and pieces we will need, in the next 
part of this series we will go 
through the available compilation 
options, and actually end up by 
compiling our First kernel. 



Alan teaches computer science at 
Escola Andorrana de Batxillerat 
(high-school). He has previously 
given GNU/Linux courses at the 
University of Andorra and GNU/Linux 
systems administration at the Open 
University of Catalunya (UOC). 
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REVIEW 

Written by Oscar Rivera 


E ver since I first began using 
Linux, I've used proprietary 
drivers only when it was absolutely 
necessary. In Fact, back then 
(during the release of Ubuntu 
10.04 LTS), I noticed that the free 
open-source drivers worked better 
than the proprietary Nvidia drivers 
that my desktop needed at the 
time. About a year later, when I 
built a new computer, although I 
now had an AMD graphics card, I 
decided to stick with the open- 
source drivers instead of AMD's 
own drivers. Fast-forward a couple 
of years and another custom-built 
PC - to arrive at the present time, 
September 201 4. A lot has changed 
in the last year, and it's mostly due 
to Valve's Steam video game 
engine being ported to Linux. I 
remember about two years ago 
when Linus Torvalds himself gave 
Nvidia a not-so-friendly hand-sign 
because of Nvidia's lack of 
cooperation with the Linux 
community. 


Ever since then, Nvidia has been 
making the effort to improve their 
relationship with us Linux folks. 
Nvidia's main competitor, AMD, 


AMD Catalyst 14.6 Beta Drivers 


didn't wait to get the finger from 
Linus in order to spring into action. 
AMD's Catalyst graphics drivers 
have lately been keeping up with 
the increasing demands of the new 
influx of games that are currently 
saturating the Linux market. As a 
gamer, I need to have the latest 
graphics drivers installed in my 


system. Ever since Valve's Steam 
video game engine strongly 
suggested that we use the latest 
proprietary graphics drivers for a 
smooth playing experience, I've 
been using the latest AMD Beta 
driver available through Ubuntu's 
Additional Drivers application (in 
Linux Mint the application is called 


Driver Manager). However, I've 
been aware that the latest Beta 
driver provided by Additional 
Drivers is NOT the latest AMD Beta 
available for installation. 

For this month's Video Game 
Reviews, I have been playing The 
Witcher 2: Assassin of Kings 
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REVIEW 


Enhanced Edition, which has 
perhaps the best graphics I've yet 
seen in a Linux video game. In 
order for me to play the video 
game 'The Witcher 2', it was 
suggested that I install the latest 
AMD Beta directly from the AMD 
website. My determination to play 
the video game drove me to figure 
out how to install it. I was 
pleasantly surprised to discover 
that the instructions on the 
website were pretty simple, 
straight-forward, and to the point. I 
downloaded the driver from: 
http://support.amd.com/en- 

us/kb-articles/Paaes/Latest- 

LINUX-Beta-Driver.aspx 

I then followed the directions 
given on: 

http://support.amd.com/en- 

us/kb-articles/Paaes/Catalvst- 

Linux-lnstaller-Notes.aspx 

Rather than turn this review 
into a How-To, I simply recommend 
that you pay attention to the 
instructions provided on AMD's 
website, and follow them as close 
as possible. Not only are the 
instructions easy to follow, but the 
actual AMD Catalyst Beta installer 
is also very user friendly, intuitive 
and makes it almost as easy to 
install as if you were using your 


distro's Software Center. I am very 
impressed with AMD's efforts to 
provide us with the latest drivers 
they have to offer. After a quick 
reboot, the new graphics driver 
should be working just fine. With 
the true latest AMD Beta 14.6 from 
the AMD website, I was able to play 
The Witcher 2 without any 
problems. The process of installing 
the AMD Beta Catalyst driver took 
less than 15 minutes and 
everything works better than 
before. 

The only Con I find with using 
the AMD Catalyst Beta 1 4.6 is that 
it's a proprietary driver. On the 
other hand, there is a long list of 
Pro's. There is so much to gain from 
using this proprietary driver: it's 
easy to install, your games will play 
much better, and your desktop 
effects will look more impressive as 
well. I strongly recommend it to 
anyone who has an AMD Radeon 
HD 5xxx or newer graphics card, 
and is interested in playing the new 
flurry of video games that are 
trickling their way down into our 
beloved operating system. 
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MY STORY 

Written by Kostas Kotoulas 


T aking advantage oF your call 
For personal stories, I'm 
sending you mine. It was back in 
December 1997, when I was on my 
mandatory 1 8-month tour in the 
Army (I'm Greek and still to this day 
there is a mandatory tour For all 
Greek males, although it's 9 
months now). During a training 
break, I was talking with another 
guy who had, prior to his tour, 
Finished his master's in Computer 
Science From a university in the 
USA (don't recall which). We were 
talking about the impact the then 
new Windows 95 had on PCs, and I 
was whining because I still owned a 
486DX/33MHZ PC which couldn't 
run Windows 95. 

So he said "try Linux". "What's 
that?" I asked (intrigued by the very 
name). He started to talk about it, 
mentioning how it is a Unix-like OS 
(I had previous experience with 
Unix on a VAX machine back in my 
university years), very light, and 
that my humble hardware would 
be perFect For it. 

On my next leave, I went to a 
Friend who was still in the 


university (back on those days only 
universities had good internet 
access in Greece, dial-up 
connections were still at 14400 
bps), and downloaded a distro in 
about 8 or 9 Floppies. I think it was 
Slackware or Debian, not sure. Got 
home, did the installation, and a 
couple oF hours later — through an 
agonizing 2nd install because oF 
mistaken conFigurations — I saw a 
login screen! It took me all three 
days oF my leave to read just the 
essential texts to get some idea 
but that was it: I was hooked For 
liFe. 


Although because oF work (I'm a 
computer technician), I was Forced 
to have a Windows machine at 
home, I always used a GNU/Linux 
OS on my old hardware; at the start 
an Athlon XP 2000, later a 
P4/3.0GHz; but since I got laid oFF 
(damn Greek Crisis) three years 
ago, I use a GNU/Linux OS on my 
main PC too. I have used Slackware, 
Debian, Suse, openSuse, Mint, 
Redhat, Fedora, Mandrake, Mageia. 
and, oF course, Ubuntu. Usually I 
had two or three distros at a time 
on diFFerent hdds For comparison. 
Although Debian is still my Favorite 


Flavor, I really love Ubuntu's LTS 
versions and I think they are the 
best distro a beginner can use 
because oF the Fact that you will 
use roughly the same version For 
two, maybe three, years — enough 
time For a beginner to become an 
advanced user. I think that the 
Features oF Ubuntu that beginners 
really like are the easy update 
process, the Fact that the root 
account is locked — leading to 
Fewer mistakes For an 
inexperienced user — and the vast 
number oF applications available. 
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FUEV, L00K.1 
mi?, forever 

AL ONE HAS 
LRETURNEP.J 


STUFIP 

PLAN, 


AMP THINGS FIN ALL V STARTEP 
TO CHANGE, 


1 1 • M J 


HELL, 

yeah/ 


BUT ONE PARK NIGHT, THE 
MAP MASTER CAME RACK TO| 
HIS LAE WITH A STRANGE 
GAZE ON HlS EYES, 


WWW . P&N^PCRLOUCCXCOM 


PLEASE, 
SHOOT 
mE, . 


BUT THE PLAN PIPN'T WORK. THE 
BRAIN WAS TOO GRUMPY TO BE 
GOOP COMPANY, NO MATTER WHAT 
THE SCIENTIST PIP TO CHANGE IT. 


IT WAS THE WEIRP PLAN OF A MAP 
SCIENTIST, ANP YOU KNOW HOW 
MAP SCIENTISTS GET WHEN THEY 
.ARE LONELY ANP PEPRES5EP, 


HE SAIP NOTHING 
AT FIRST, HE TOOK A 
BOTTLE FROM HlS 
BRIEFCASE, HE THEN 
OPENEP IT.., 


I KNEW/ IT/ ALL 
YOU NEEPEP WAS 
some INCENTIVE/ 


Tl 


Ofr 


T6LL. me' HOW ABOUT 
WE PLAY SOME POKER ANP 
INVITE THE BABES? 
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If you have a Linux question, email it to: misc@fullcirclemagazine.org, and 
Gord will answer them in a future issue. Please include as much 
information as you can about your query. 



Q l accidentally deleted the 
indicator-applet when trying 
to remove another applet in the 
taskbar. When logging in as 
another user everything is as it 
should be. What do I have to do to 
make this applet re-appear on my 
taskbar? 

A (Thanks to ibjsb4 in the 
Ubuntu Forums) Alt-right- 
click, Add to panel, choose 
indicator applet. 

Q I just started using Ubuntu, I 
want to install Eclipse CDT. 

A Open Software Centre, search 
for Eclipse CDT, click on 
Install. It's pretty different from 
what you are used to. 

I am using the Gnome 3 
desktop on Ubuntu 14.04. 1 use 
two monitors. I can reset them to 
the correct positions using nvidia 
xserver or the display setting, but 
they stay the right way round only 
until the next reboot. 


A (Thanks to bizhat in the 

Ubuntu Forums) When Nvidia 
xserver gives the option to save 
the changes, save them in 
xorg.conf in folder /etc/X1 1 

Q ls there a software solution 
for updating a Linux server 
with no internet? 

yy You can use apt-offline. 


Q l have installed the drivers for 
[some program] in WINE, but it 
doesn't work. 

A (Thanks to VtadleninSOO in 
the Ubuntu Forums) No, 
certainly not. WINE runs SOME 
Windows apps. It doesn't (it can't) 
work with drivers. 


Q l accidentally sent a print job 
to a printer I no longer own. 
Now I get a message popping up, 
saying there is a problem. Flow can 
I make it stop? 


A You need to clear the print 
queue. To see what is in the 
queue, use the command: Ipq 

To clear the queue, use the 
command: cancel -a 

Q FIow can I have a few 

confidential files stored in an 
encrypted folder? 

A Use encfs, with its front-end 
program called Cryptkeeper. 
In the Ubuntu Forums there is a 
tutorial created in 2006 which is 
still relevant today. (Google: encfs 
ubuntuforums) There are also 
online tutorials for Cryptkeeper, 
which shows up as an icon on the 
taskbar. 


Top questions at 
Askubuntu 

* Find out the application under 
the mouse 

http://qoo.ql/FIPrtdZ 


* flashplayer not working in 
Chromium 

http://qoo.ql/PQpfD4 

* AVG antivirus not working 
http://qoo.ql/hsOLPz 

* FIDMI audio not working on TV 

http://qoo.ql/TfMCzh 

* No GRUB Screen or recovery 
mode on Boot after 1 2.04 Upgrade 

http://qoo.ql/PlRFIOv 

* Can I see in a log file all GUI 
based tasks in its alternative 
command-line format? 

http://qoo.ql/qxkh5k 

* Problem accessing Windows 
Share from Ubuntu using Samba 

http://qoo.ql/KNWwt6 

* An Ubuntu command bricked my 
system? 

http://qoo.ql/93aSrk 

* Is it okay to use symbolic links in 
my web server? 

http://qoo.ql/VXbXBq 
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O&A 

Tips and Techniques 

Like a Fine wine, it gets better 
with age. 

A five-year-old Acer Aspire One 
netbook recently fell into my 
lap. It had Windows XP installed, 
which is not acceptable in my home 
or office, so I decided to give 
Xubuntu 14.04 a spin. 

The specs for this little 
computer are not impressive. The 
8.5-inch (diagonal) screen 
resolution is 1024 by 600, roughly 
one-quarter of the size and 
resolution of my Dell Ultrasharp 
monitor. The keyboard is shrunken 
by 1 0%, and some of the keys are 
in unusual locations. The CPU is a 
single-core, 32-bit Atom N270 
running at a maximum of 1.6 GHz. 
The machine has a gig of memory 
and a 1 60 GB hard drive. There are 
three USB 2.0 ports, an Ethernet 
port, VGA and audio ports, Wi-Fi 
and a low-resolution webcam. 

On the positive side, the five- 
year-old battery will run the 
computer for over two hours, and 
it appears to be quite physically 
robust. It's also small and light, 
compared to a typical laptop. 


I remember browsing the 
forums when this computer wJ 
new, and there were lots of people 
asking, "how do I get such-and-such 
working." Installing Xubuntu was 
slow, but it went very smoothly. 
When I booted the installed 
system, everything just worked! 

There was one puzzle for me: 
the installed system knew about a 
printer which was not connected to 
any computer at the time, nor was 
it plugged in. Huh? 

Xubuntu doesn't include a 
webcam program, but guvcview 
installed easily and just worked. 

I installed Im-sensors, hddtemp 
and conky. One benefit of the low- 
powered CPU: it never gets very 
hot. I was very surprised by how 
little memory is used when the 
system boots up. 

The computer plays youtube 
videos just fine, although I'm sure 
it's dropping lots of frames. 

After installing Samba, I could 
access shared folders on the 
network, and eventually set up a 
shared folder on the netbook. 
Under Xubuntu, it was no easier 


than setting up a shared folder in 
Ubuntu Server, with no GUI. (See 
last month's Q&A). 

I installed xl Ivnc so I could 
control the computer remotely, 
using KRDC in Linux, or RealVNC in 
Windows. That meant I could use 
the machine as a remote camera, as 
well as a small file server. 

The small screen and slow CPU 
make this far from my favorite 
computer. However, free Wi-Fi is 
available everywhere these days, 
and the portability makes this a 
viable option for when I'm out and 
about. 



Gord had a long career in the 
computer industry, then retired for 
several years. More recently, he 
somehow found himself "The IT Guy" 
at a 1 5-person accounting firm in 
downtown Toronto. 
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Full Circle Podcast 
Episode 41, Trusted 
To Fail!! 

Welcome to our new format 
show, there are several 
changes from the previous 
format, the most important 
being we are now recording 
together at the Blackpool 
Makerspace in the office. 

This Episode we Test Ubuntu 
14.04, Review of Official 
Ubuntu Server Book. 

Your hosts: 

• Les Pounder 

• Tony Hughes 

• Oliver Clark 

from the 

Blackpool (UK) LUG 
http://blackpool.luq.orq.uk 


Download 
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The Witcher 2 



UBUNTU GAMES 

Written by Oscar Rivera 


T he Witcher 2: Assassins of 
Kings Enhanced Edition has 
recently become available for Linux 
and I'm happy to report that it 
plays well. The Witcher 2: Assassins 
of Kings Enhanced Edition is an 
action, role-playing video game 
developed by CD Projekt RED and 
published by Warner Bros. (Note 
that only the Enhanced Edition is 
published by Warner Brothers). The 
game was originally released in 
May 2011 for Microsoft Windows, 
with a follow-up release in 201 2 for 
Xbox 360. Although it was released 
for Linux early in Summer 2014, it 
wasn't until mid-August that I was 
able to play it without any crashes 
or glitches on my Ubuntu desktop. 
The Witcher 2: Assassins of Kings 
Enhanced Edition is undeniably one 
of the best additions to the rapidly 
growing Linux video game library. 

When I found out that The 
Witcher 2: Assassins of Kings 
Enhanced Edition had become 
available for Linux, I felt like a kid 
on Christmas morning. I 
immediately went to the Steam 
Store to buy the game, but I first 
looked up the Minimum and 


Recommended System 
Requirements for the game before 
making the purchase. Not to my 
surprise, I found out that my 
graphics card was not listed. In fact, 
only Nvidia graphics cards were 
listed; no AMD or Intel graphics 
cards were supported. According 
to the System Requirements at the 
time, you needed to have a 
GeForce 9800 GT 512MB or better 
AND it specifically said: 

We recommend the following 
drivers: 

• nVidia - nvidia binary driver 
331.79 or later 

• MESA based drivers (e.g. 
"nouveau") are not currently 


supported. 

• Intel integrated graphics are not 
currently supported. 

What a bummer! Even though I 
had a more than capable graphics 
card, I wasn't able to play the 
game. After continuously checking 
on the Steam Forums and The 
Witcher 2 Steam Store page, three 
weeks later I finally saw that other 
Linux gamers had been successful 
in playing The Witcher 2 with AMD 
graphics cards. I went through the 
trouble of installing AMD's Catalyst 
14.2 Beta graphics driver from 
AMD's website and successfully 
played the game on my computer. 
Apparently, AMD acknowledges 
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that there is a substantial enough 
amount of Linux users to maintain 
Linux drivers as current as 
Windows and Mac drivers. Things 
are definitely changing for the 
better in the Linux gaming world 
and it is affecting desktop Linux as 
a whole. 

The Witcher 2: Assassins of 
Kings Enhanced Edition was well 
worth the hassle and the wait. As 
soon as I started playing the game I 
was instantly hooked. The main 
character, Geralt of Rivia, an 
undead mutant, is the title's 
witcher, who uses swords and 
sorcery as part of his combat 
repertoire. The game-play is very 
smooth from the beginning and 
improves as the game progresses. 
The graphics are phenomenal 
throughout the game but 
especially stunning during the 
cinematic cut-scenes. Often, while 
being absolutely captivated by the 
striking animation and the 
intricacies of the plot-line, you are 
suddenly thrown into intense 
combat situations which require 
quick reflexes in order to stay alive. 
The storyline, rich in magic, politics, 

contents ~ 


UBUNTU GAMES 


romance, revenge and fantasy, is a 
little hard to follow at first but it 
doesn't take long for it to start 
making sense as the game gets 
going. As an RPG, the story takes 
different paths depending on your 
decisions made while in dialogue 
with other characters. The voice- 
acting dialogue is superb and 
accordingly fits the wide variety of 
characters you encounter in the 
game. The character development 
portion of the game is not to be 
taken lightly as it has a very direct 
effect on game-play and each point 
should be spent on abilities that 
will enhance your playing style. 

Perhaps my only complaint 
about this game is the ridiculously 
short and seemingly incomplete 
tutorial at the beginning of the 
game. It seems like you have just 
started playing the game when the 
tutorial ends and you are left to 
play the game with less than 25% 


of knowledge of your full 
capabilities. Saying that The 
Witcher 2 has a steep learning 
curve at the beginning is an 
understatement. I had to re-play 
the tutorial a couple of times 
before realizing that I'd be better 
off looking for help elsewhere, like 
for example ign.com. I first played 
using my keyboard/mouse because 
I couldn't get my Razer gamepad 
controller to work; besides, the 
game was originally released for PC 
and later for the Xbox360 game 
console, so using the 
keyboard/mouse is how it was 
meant to be played. After looking 
for help in the Steam forums, I was 
able to get my controller to work 
for this game. In the process, I 
noticed the high level of 
commitment given to the game's 
Linux port as evidenced by one of 
the developer's efforts to get my 
controller to work. 


Minimum System Requirements: 

• OS: Ubuntu 1 2.04 LTS, Steam OS 

• Processor: Intel Core 2 Duo 

• Memory: 4 GB RAM 

• Graphics: GeForce 9800 GT 51 2MB 
(1280x720, low) 

• Hard Drive: 25 GB HD space 


My Gaming Setup 

I played The Witcher 2: Assassins of Kings 
Enhanced Edition with my custom made 
desktop PC consisting of an AMD FX-61 00 
3.3GHz CPU, an Asus M5A97-EVO 
motherboard, a Sapphire Radeon HD 5770 
graphics card, 8GB of Kingston Hyper X 
RAM, and a 1TB Seagate Barracuda hard 
drive. The software used was Ubuntu 
14.04 LTS with Unity and AMD 14.2 Beta 
Catalyst proprietary graphics driver. 


Conclusion 

Pro's 

• Stunning detail, deeply textured 
scenery, amazing cinematic cut- 
scenes make the graphics in this 
game some of the best I've ever 
seen for any game. 

• Multi-accented voice-acting 
breathes life into each of the many 
diverse characters. 

• Politically intriguing plot with 
shades of magic and a touch of 
romance teleports you into a 
medieval fantasy that keeps you at 
the edge of your seat wondering 
what will happen next. 
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• The role-playing genre is taken to 
new heights with The Witcher 2's 
radically different consequences 
highly dependent on your choices. 

• Easy to navigate, once you get the 
hang of it, whether you use 
keyboard/mouse or a controller 
gamepad. 

Con's 

•Tutorial is much too short and 
may as well not even exist for all it 
teaches you. 

• Proprietary graphics drivers 
REQUIRED to play this game. 

All in all, this is one of the best 
games I've ever had the pleasure of 
playing. If you don't mind using 
proprietary graphics drivers in your 
system and you're into action- 
adventure, role-playing games, 
then spend the $1 9.98 that Steam 
is asking for this game. 



Oscar graduated from CSUN, is a 
Music Director/Teacher, beta tester, 
Wikipedia editor, and Ubuntu Forums 
contributor. You can contact him via: 

www.qpiu s.to /7bluehand or email: 
www.7bluehand(3>qmai[.com 
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O V UBUNTU GAMES 

Written by Ronnie Tucker 


X-Plane 10 


O nce upon a time, Microsoft 
Flight Simulator was 'thee go 
to' flight simulator. Nothing could 
touch it. Then came along free 
equivalents such as flightgear. 
Creeping up behind them was X- 
Plane - a far more sophisticated 
flight sim that really did what a 
flight sim should do. It took the 
model, and applied physics to it, 
and at that point you really were an 
X pilot - testing out unknown 
planes. Microsoft's effort has since 
fallen by the wayside. It never truly 


simulated a model plane in physics. 
Every plane model needed botches 
to make it seem right, and as of 
Flight Simulator X it hasn't been 
updated. X-Plane, on the other 
hand, has matured nicely and is, as 
of writing, at 1 0.2 with 1 0.3 in beta. 

The problem with X-Plane was 
that it was huge. And I mean 
massive. It came spanning almost a 
dozen DVDs and was available only 
as a physical object. The makers 
have changed that now by having 



X-Plane available to download via 
Steam. And about time too! The 
download is not for the faint of 
heart. My install of just X-Plane 1 0 
and the European scenery is 
around the 8GB mark. 
Downloading the rest of the world 
will get you a grand total of 80GB. 

Getting Started 


Once your download is 
complete, you can start X-Plane 
and get the quick-start window. It's 
ironic that they call it the 'quick 
flight' — getting to that window 
took a full two minutes on my 
Quad Core 2, 8GB RAM machine! 
Once there, you quickly choose a 
plane from the default list, a 
location (airport), and a weather 
type. To get into the pilot's seat 
takes a further three minutes of 
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loading time. You start on the 
runway with the engine running 
ready for take off. 

You can, if you wish, move your 
mouse to the top of the screen to 
access the menu and bring up the 
location map. This shows you, and 
some Al planes, on the map. From 
here, you can see some basic 
airport info (radio channels, etc), 
and also the ability to toss your 
plane into the sky at an 
altitude/speed of your choosing. 
You can also choose from the 
preset buttons to have your plane 
in the sky heading for a landing. 


Handy for practice. Something 
you'll need. 

How On Earth Do I... 

Inevitably, you'll be sitting there 
in the cockpit not having a clue 
what to do. X-Plane does come 
with a manual (don't worry it's only 
1 85 pages), but it's pretty generic 
as every plane has a different 
cockpit and features that are 
unique to that plane. You can 
quickly learn to fly a single engine 
Cessna, but that won't help you a 
jot if you load up a monster 
737/747. Sure, you'll know the 



basic dials, but everything above a 
Cessna may need a knowledge of 
the flight computer (FMC) or a 
knowledge of waypoints and flight 
plans. It's all heady stuff and a lot 
to take in. From my short time 
(thus far) of using X-Plane I'll give 
you this piece of advice: remember, 
it's a simulator. If you want to know 
something, look at the real-world. 
Watch videos on YouTube of actual 
flights. What you see in real life is 
what you need to do in X-Plane. 

Scenery And Add-ons 


nothing like the real thing. This can 
be fixed by using add-on scenery. 
Similarly, while it does have 
Glasgow, it looks nothing like 
Glasgow does in Google Maps. This 
is rectified by using more add-ons. 
Once you have a couple of these 
installed, your X-Plane will look 
fantastic. If your PC can handle it 
that is. 

There are a myriad of add-ons; 
realistic sky/clouds/weather, 
aircraft, online ATC, the list goes 
on. 


While X-Plane looks OK in the 
graphics department, I recommend 
you install some scenery packs. X- 
Plane has the locations (eg: 
Glasgow Airport), but it looks 


Controls 

I use a Mad Catz FLY 5 stick 
which works excellently with X- 
Plane. Thankfully, X-Plane is highly 
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configurable. In the 
Joystick/Buttons menu, you have 
complete control over the 
configuration - by pressing a 
button on your stick and then 
choosing which feature it should 
control. It does, of course, allow 
tweaking of joystick sensitivity and 
joystick calibration. Further in- 
depth configuration can be done 
using plugins, but I'll talk more 
about that next month. Hint: it 
involves using a webcam to look 
around your 3D cockpit. 

Conclusion 

Make no mistake about it, this is 
not a game. This is a simulation 
with so much to learn that it's quite 
frightening, but don't let it get to 
you. You can treat this as either a 
friendly simulator (ie: quick flight, 
no ATC, A to B), or as a full-on sim 
(ie: get a flight plan online, use 
real-time online ATC, use auto- 
pilot, etc) - it's entirely up to you. 

While I definitely have a longer 
list of CONS than PROS for this 
review, I still think X-Plane is a 
fantastic piece of software. Yes, it 
may seem expensive (£44.99 as I 
write this), but it has a ton of add- 
ons and plugins - most of which are 


free. I do have to deduct a star for 
its long loading time; it really is 
unforgivable and something that I 
hope will be fixed. The other 
downsides can easily be fixed with 
free add-ons/plugins. 

Next month, I'll show you how 
to install the free Python installer 
plugin (that allows you to run 
Python scripts in X-Plane), then use 
it to show your plane's real-time 
position on a map. But we'll save 
that for Foxtrot, Charlie, Mike, 
niner, zero. 

X-Plane 10 requires, at the 
minimum: 

• Dual Core, 2.5 GHz or faster 

• 2 GB of RAM 

• A video card with at least 500 MB 
of VRAM. 


PROS: 

• Looks gorgeous when you have 
additional scenery installed 

• You can effectively download the 
entire world's landscape 

• Plugin architecture allows for 
more planes/scenery/features 

CONS: 

• Can't easily do multi-monitor 
cockpit display 

• Some plugins aren't Linux 
compatible (eg: SkyMaxx for 
improving skies) 

• Landscape is a bit bland and lacks 
detail (can be fixed with addons) 

• Locations and airports aren't 
always based on fact (again, can be 
fixed with addons) 

• Extremely steep learning curve as 
every plane is different 
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• Some cockpits are quite blurry on 
closer (3D) inspection 

• Takes far too long to load 

• Download size can be anywhere 
from 8GB to 80GB depending on 
what parts of the world you want 
installed 

• Could be considered quite 
expensive for a 'game' 

• Takes a hefty machine to run the 
game with detailed scenery, 
buildings, shading and traffic. 

For help and addons: 
http://forums.x-plane.org/ 

Plane used in the screenshots is 
the Eclipse 550: http://forums.x- 
plane.orq/index.php?app=downloa 

ds&showfile=18661 

Google Maps based scenery: 
http://simheaven.com/ 



Ronnie is the founder and (still!) 
editor of Full Circle. He's a part-time 
arts and crafts sort of guy, and now 
an Arduino tinkerer. 
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MY DESKTOP 


Your chance to show the world your desktop or PC. Email your screenshots and 
photos to: misc@fullcirclemagazine.org and include a brief paragraph about your 
desktop, your PC's specs and any other interesting tidbits about your setup. 



TIME : DM1 




UPTIME* 0H45M47S 
TEMP: 5BC 

CPU: 1M2 MHZ 

PEOC: 153(0FlUflJ 
LOAD: 0.3B D.30 D2E) 



CPU1 

CPU2 


HQI^E. 


196GIB 


Audacious 


09:01 



I am using a computer with 
Xubuntu operating system. I use a 
netbook Axioo Pico W21 7CU that 
has a relatively small display, only 


10 inches. However I wanted to 
have a large workspace, and 
therefore made the panel in 
deskbar mode. Then I made a more 


transparent panel and I set it to 
autohide. I am using a numix 
desktop theme, numix circle icon 
theme, and conky with a standard 


theme. These themes give me 
more Freedom to work with my 
computer. 
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This is the beta version of 
Elementary Freya (32-bit version) I 
am testing on an Acer Aspire One 
(1 .6 GHz Intel Atom). The user 
interface is the way I like them: 
minimalistic, functional and 
elegant. Gtk3 libraries work as 


expected, with desktop effects 
present but low-key. There is not 
much installed on this low-powered 
machine: just the Chromium 
browser to access Google Drive, a 
file-browser and, of course, the 
command-line terminal. 


I am very pleased with the 
general feel and look of the Ul, 
although processor and memory 
use are way higher that they should 
be. This *is* a beta version, after 
all. I am waiting for the final 


product to come out, then will 
surely adopt it. 

Alan Ward 


full circle magazine #89 55 


ft 


contents 






HOW TO CONTRIBUTE 


FULL CIRCLE NEEDS YOU! 

A magazine isn't a magazine without articles and Full Circle is no 
exception. We need your opinions, desktops, stories, how-to's, reviews, 
and anything else you want to tell your fellow *buntu users. Send your 
articles to: articles@ fullcirclemaqazine.org 




FCM#89 

Deadline: 

Sunday 12th Oct. 2014. 

Release: 

Friday 31st Oct. 2014. 


We are always looking for new articles to include in Full Circle. For help and advice please 

see the Official Full Circle Style Guide: http://url.fullcirclemaqazine.org/75d471 


Send your comments or Linux experiences to: etters@fullcirclemaqazine.org 
Flardware/software reviews should be sent to: reviews@fullcirclemaqazine.org 
Questions for Q&A should go to: questions@fullcirclemaqazine.org 

Desktop screens should be emailed to: misc@fullcirclemaqazine.org 
... or you can visit our forum via: fullcirclemaqazine.org 



Full Circle Team 


Editor - Ronnie Tucker 

ronnie@fullcirclemaqazine.org 

Webmaster - Rob Kerfia 
admin@fullcirclemaqazine.org 

Podcast - Les Pounder & Co. 
podcast@fullcirclemaqazine.org 


®| 
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Mike Kennedy, Gord Campbell, Robert 
Orsino, Josh Hertel, Bert Jerred, Jim 
Dyer and Emily Gonyer 


Our thanks go to Canonical, the many 
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Getting Full Circle Magazine: 


■ 


EPUB Format - Recent editions of Full Circle have a link to the epub file on the downloads page. If you have any problems with 
the epub file, you can drop an email to: mobile@fullcirclemaqazine.org 



Issuu - You can read Full Circle online via Issuu: http://issuu.com/fullcirclemaqazine . Please share and rate FCM as it helps to 
spread the word about FCM and Ubuntu Linux. 



Google Play - You can now read Full Circle on Google Play/Books. Either search for 'full circle magazine' or 
click this link: https://plav.qooqle.com/store/books/author?id=Ronnie+Tucker 
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